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

# Parole vers Texte

Pour convertir de la parole en texte à l'aide de l'API sunra, vous devez envoyer une requête au point de terminaison approprié avec les paramètres d'entrée requis. L'API s'appuie sur des modèles pré-entraînés pour transcrire des fichiers audio en texte, permettant une conversion transparente en fournissant simplement un fichier audio.

Voici comment vous pouvez utiliser l'API sunra pour la conversion de la parole en texte :

<CodeGroup>
  ```javascript Javascript theme={null}
  import { sunra } from "@sunra/client";

  const result = await sunra.subscribe("elevenlabs/scribe-v1/speech-to-text", {
    input: {
      audio: 'https://assets.sunra.ai/uploads/1749243418768-74d68e25.wav',
      language: 'English',
      tag_audio_events: true,
      speaker_diarization: false
    },
    logs: true,
    onQueueUpdate: (update) => {
      console.log(update)
    },
  });
  console.log(result.data);
  console.log(result.requestId);
  ```

  ```python Python theme={null}
  import sunra_client

  result = sunra_client.subscribe(
      "elevenlabs/scribe-v1/speech-to-text",
      arguments={
          "audio": "https://assets.sunra.ai/uploads/1749243418768-74d68e25.wav",
          "language": "English",
          "tag_audio_events": True,
          "speaker_diarization": False
      },
      with_logs=True,
      on_enqueue=print,
      on_queue_update=print,
  )
  print(result) 
  ```

  ```java Java theme={null}
  import ai.sunra.client.*;
  import java.util.Map;
  import com.google.gson.JsonObject;

  var client = SunraClient.withEnvCredentials();

  var response = client.subscribe(
      "elevenlabs/scribe-v1/speech-to-text",
      SubscribeOptions.<JsonObject>builder()
          .input(Map.of(
              "audio", "https://assets.sunra.ai/uploads/1749243418768-74d68e25.wav",
              "language", "English",
              "tag_audio_events", true,
              "speaker_diarization", false))
          .resultType(JsonObject.class)
          .onQueueUpdate(update -> System.out.printf(
              "\nMise à jour du statut : %s, ID de la requête : %s%n",
              update.getStatus(),
              update.getRequestId()
          ))
          .logs(true)
          .build()
  );

  System.out.println("Terminé !");
  System.out.println(response.getData());
  ```

  ```bash Curl theme={null}
  curl --request POST \
    --url https://api.sunra.ai/v1/queue/elevenlabs/scribe-v1/speech-to-text \
    --header "Authorization: Key $SUNRA_KEY" \
    --header "Content-Type: application/json" \
    --data '{"audio":"https://assets.sunra.ai/uploads/1749243418768-74d68e25.wav","language":"English","tag_audio_events":true,"speaker_diarization":false}'

  ```
</CodeGroup>

### Choisir le bon modèle

sunra propose une gamme de modèles de conversion de la parole en texte pour répondre à différents besoins. Sélectionnez un modèle en fonction de vos exigences en matière de précision et de performance.

Voici quelques options disponibles :

* **[elevenlabs/scribe-v1](https://sunra.ai/models/elevenlabs/scribe-v1)** : Conversion de la parole en texte en 99 langues avec horodatage au niveau du mot et diarisation — l'ASR la plus précise de l'entreprise à ce jour.

Pour utiliser un modèle spécifique, spécifiez son ID dans la méthode `subscribe` comme indiqué dans l'exemple. Pour plus de modèles et de détails, visitez la page [Modèles de parole vers texte](https://sunra.ai/models?modalities%5B0%5D=modality-audio-text).
