> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenLabs parole en texte V2

Transcrit des fichiers audio ou vidéo. Lorsque use\_multi\_channel vaut true et que l'audio téléversé comporte plusieurs canaux, renvoie un objet 'transcripts', avec une transcription par canal. Sinon, renvoie un résultat de transcription unique.

## En-têtes de requête

<ParamField header="Content-Type" type="string" required={true}>
  Valeurs d’énumération : `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Format d’authentification Bearer : Bearer \{\{API Key}}.
</ParamField>

## Corps de la requête

<ParamField body="seed" type="integer" nullable={true}>
  Si spécifié, le système fera de son mieux pour échantillonner de manière déterministe ; les requêtes avec le même seed et les mêmes paramètres devraient renvoyer le même résultat, sans garantie de déterminisme absolu. Doit être un entier compris entre 0 et 2147483647.

  Plage de valeurs : \[0, 2147483647]
</ParamField>

<ParamField body="diarize" type="boolean" default={false}>
  Indique s’il faut annoter le locuteur actuel dans le fichier téléversé.
</ParamField>

<ParamField body="file_format" type="string" default="other">
  Format audio d’entrée. Peut être 'pcm\_s16le\_16' ou 'other'. pcm\_s16le\_16 exige un audio à une fréquence d’échantillonnage de 16 kHz, en entier 16 bits, mono, au format little-endian, avec une latence plus faible que les formes d’onde encodées.

  Valeurs possibles : `pcm_s16le_16`, `other`
</ParamField>

<ParamField body="temperature" type="number" nullable={true}>
  Contrôle le caractère aléatoire de la sortie de transcription. La plage de valeurs est de 0.0 à 2.0 ; plus la valeur est élevée, plus les résultats sont variés et moins déterministes. Si omis, la température par défaut du modèle sélectionné sera utilisée (généralement 0).

  Plage de valeurs : \[0, 2]
</ParamField>

<ParamField body="num_speakers" type="integer" nullable={true}>
  Nombre maximal de locuteurs dans le fichier téléversé. Peut être utilisé pour aider à distinguer les locuteurs ; jusqu’à 32 locuteurs sont pris en charge.

  Plage de valeurs : \[1, 32]
</ParamField>

<ParamField body="language_code" type="string" nullable={true}>
  Spécifie le code de langue ISO-639-1 ou ISO-639-3 du fichier audio. L’indiquer à l’avance peut parfois améliorer les performances de transcription. La valeur par défaut est null, et la langue sera détectée automatiquement.
</ParamField>

<ParamField body="tag_audio_events" type="boolean" default={true}>
  Indique s’il faut marquer dans la transcription les événements audio tels que (laughter) ou (footsteps).
</ParamField>

<ParamField body="cloud_storage_url" type="string" required={true} nullable={true}>
  Lien HTTPS du fichier à transcrire. L’un des deux champs file et cloud\_storage\_url doit être fourni. Le fichier doit être accessible via HTTPS et faire moins de 2 Go ; toute adresse HTTPS valide est prise en charge, y compris le stockage cloud (AWS S3, GCS, Cloudflare R2, etc.), un CDN ou d’autres sources HTTPS. Les liens présignés avec token ou l’authentification par paramètres de requête d’URL sont pris en charge.
</ParamField>

<ParamField body="use_multi_channel" type="boolean" default={false}>
  Indique si le fichier audio est multicanal et si chaque canal ne contient qu’un seul locuteur. Une fois activé, chaque canal est transcrit indépendamment et les résultats sont fusionnés ; chaque mot du contenu de sortie inclut un champ channel\_index. Jusqu’à 5 canaux sont pris en charge.
</ParamField>

<ParamField body="diarization_threshold" type="number" nullable={true}>
  Seuil de séparation des locuteurs (diarization). Lorsque la valeur est élevée, la probabilité qu’une même personne soit divisée en plusieurs locuteurs est faible, mais la probabilité que différentes personnes soient fusionnées en un seul locuteur est élevée (moins de locuteurs détectés) ; lorsque la valeur est faible, la probabilité qu’une même personne soit divisée en plusieurs locuteurs augmente, mais la probabilité que différentes personnes soient fusionnées diminue (plus de locuteurs). Ne peut être défini que lorsque diarize=True et num\_speakers=None. La valeur par défaut est None ; le seuil est choisi en fonction de l’id du modèle (généralement 0.22).

  Plage de valeurs : \[0.1, 0.4]
</ParamField>

<ParamField body="timestamps_granularity" type="string" default="word">
  Granularité des horodatages dans le contenu transcrit. 'word' fournit des horodatages au niveau des mots, tandis que 'character' fournit des horodatages pour chaque caractère.

  Valeurs possibles : `none`, `word`, `character`
</ParamField>

## Informations de réponse

<Note>
  La réponse peut être de l’un des types suivants :
</Note>

<Accordion title="Type de réponse 1">
  <ResponseField name="text" type="string" required={true}>
    Texte brut transcrit.
  </ResponseField>

  <ResponseField name="words" type="object[]" required={true}>
    Liste des mots et de leurs informations temporelles.

    <Expandable title="properties" defaultOpen={true}>
      <ResponseField name="end" type="number" required={false}>
        Heure de fin de ce mot ou de ce son dans l’audio (en secondes).
      </ResponseField>

      <ResponseField name="text" type="string" required={true}>
        Contenu du mot ou du son transcrit.
      </ResponseField>

      <ResponseField name="type" type="string" required={true}>
        Type de ce mot ou de ce son. 'audio\_event' est utilisé pour les sons qui ne sont pas des mots, comme les rires ou les bruits de pas.

        Valeurs possibles : `word`, `spacing`, `audio_event`
      </ResponseField>

      <ResponseField name="start" type="number" required={false}>
        Heure de début de ce mot ou de ce son dans l’audio (en secondes).
      </ResponseField>

      <ResponseField name="logprob" type="number" required={true}>
        Log-probabilité lors de la prédiction de ce mot. La plage de logprob est \[-infinity, 0] ; plus la valeur est élevée, plus le modèle est confiant dans sa prédiction.
      </ResponseField>

      <ResponseField name="characters" type="object[]" required={false}>
        Caractères composant le mot et leurs informations temporelles correspondantes.

        <Expandable title="properties" defaultOpen={true}>
          <ResponseField name="end" type="number" required={false}>
            Heure de fin du caractère dans l’audio (en secondes).
          </ResponseField>

          <ResponseField name="text" type="string" required={true}>
            Contenu du caractère transcrit.
          </ResponseField>

          <ResponseField name="start" type="number" required={false}>
            Heure de début du caractère dans l’audio (en secondes).
          </ResponseField>
        </Expandable>
      </ResponseField>

      <ResponseField name="speaker_id" type="string" required={false}>
        Identifiant unique du locuteur correspondant à ce mot.
      </ResponseField>
    </Expandable>
  </ResponseField>

  <ResponseField name="channel_index" type="integer" required={false}>
    Index du canal correspondant à cette transcription (valide pour l’audio multicanal).
  </ResponseField>

  <ResponseField name="language_code" type="string" required={true}>
    Code de langue détecté (par exemple 'eng' pour l’anglais).
  </ResponseField>

  <ResponseField name="transcription_id" type="string" required={false}>
    ID de transcription unique de cette réponse.
  </ResponseField>

  <ResponseField name="language_probability" type="number" required={true}>
    Niveau de confiance de la détection de langue (entre 0 et 1).
  </ResponseField>
</Accordion>

<Accordion title="Type de réponse 2">
  <ResponseField name="transcripts" type="object[]" required={true}>
    Liste des transcriptions correspondant à chaque canal audio. Chaque transcription contient le texte du canal correspondant ainsi que des informations détaillées au niveau des mots.

    <Expandable title="properties" defaultOpen={true}>
      <ResponseField name="text" type="string" required={true}>
        Texte brut transcrit.
      </ResponseField>

      <ResponseField name="words" type="object[]" required={true}>
        Liste des mots et de leurs informations temporelles.

        <Expandable title="properties" defaultOpen={true}>
          <ResponseField name="end" type="number" required={false}>
            Heure de fin de ce mot ou de ce son dans l’audio (en secondes).
          </ResponseField>

          <ResponseField name="text" type="string" required={true}>
            Contenu du mot ou du son transcrit.
          </ResponseField>

          <ResponseField name="type" type="string" required={true}>
            Type de ce mot ou de ce son. 'audio\_event' est utilisé pour les sons qui ne sont pas des mots, comme les rires ou les bruits de pas.

            Valeurs possibles : `word`, `spacing`, `audio_event`
          </ResponseField>

          <ResponseField name="start" type="number" required={false}>
            Heure de début de ce mot ou de ce son dans l’audio (en secondes).
          </ResponseField>

          <ResponseField name="logprob" type="number" required={true}>
            Log-probabilité lors de la prédiction de ce mot. La plage de logprob est \[-infinity, 0] ; plus la valeur est élevée, plus le modèle est confiant dans sa prédiction.
          </ResponseField>

          <ResponseField name="characters" type="object[]" required={false}>
            Caractères composant le mot et leurs informations temporelles correspondantes.

            <Expandable title="properties" defaultOpen={true}>
              <ResponseField name="end" type="number" required={false}>
                Heure de fin du caractère dans l’audio (en secondes).
              </ResponseField>

              <ResponseField name="text" type="string" required={true}>
                Contenu du caractère transcrit.
              </ResponseField>

              <ResponseField name="start" type="number" required={false}>
                Heure de début du caractère dans l’audio (en secondes).
              </ResponseField>
            </Expandable>
          </ResponseField>

          <ResponseField name="speaker_id" type="string" required={false}>
            Identifiant unique du locuteur correspondant à ce mot.
          </ResponseField>
        </Expandable>
      </ResponseField>

      <ResponseField name="channel_index" type="integer" required={false}>
        Index du canal correspondant à cette transcription (valide pour l’audio multicanal).
      </ResponseField>

      <ResponseField name="language_code" type="string" required={true}>
        Code de langue détecté (par exemple 'eng' pour l’anglais).
      </ResponseField>

      <ResponseField name="transcription_id" type="string" required={false}>
        ID de transcription unique de cette réponse.
      </ResponseField>

      <ResponseField name="language_probability" type="number" required={true}>
        Niveau de confiance de la détection de langue (entre 0 et 1).
      </ResponseField>
    </Expandable>
  </ResponseField>

  <ResponseField name="transcription_id" type="string" required={false}>
    ID de transcription unique de cette réponse.
  </ResponseField>
</Accordion>