TokenLab
Obtenir une clé API
DocumentationRéférence APIIntégrations

Audio & temps réel

Créer une traduction

Traduit l'audio en texte anglais

POST
/v1/audio/translations

Vue d'ensemble

Traduit l'audio dans n'importe quelle langue prise en charge en texte anglais. Contrairement à la transcription, cet endpoint renvoie toujours du texte en anglais, quelle que soit la langue d'entrée.

Cet endpoint traduit l’audio en anglais. N’envoyez pas language : ce paramètre n’est pas accepté pour la traduction audio et peut renvoyer unsupported_parameter. Pour traduire du texte, utilisez POST /v1/translations ; recommended_for=translation désigne cette API de texte.

Corps de la requête

La réponse est renvoyée après la traduction. Pour un audio long, prévoyez un délai HTTP d’au moins 120s.

filefilerequis

Le fichier audio à traduire. Formats pris en charge : flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. La taille maximale du fichier est de 25 MB.

modelstringpar défaut: whisper-1

Identifiant du modèle de traduction audio, par exemple whisper-1. Vérifiez dans ses détails actuels la prise en charge de POST /v1/audio/translations.

promptstring

Un texte facultatif pour guider le style du modèle ou poursuivre un segment précédent. Doit être en anglais.

response_formatstringpar défaut: json

Format de sortie. Whisper accepte json, text, srt, verbose_json et vtt. Les autres modèles peuvent proposer un choix différent ; vérifiez leurs détails.

temperaturenumber

Température d’échantillonnage de 0 à 1, uniquement pour les modèles compatibles avec ce paramètre.

Réponse

Les champs suivants décrivent les réponses JSON de transcription ou de traduction. text, srt et vtt renvoient du texte ou des sous-titres bruts, pas un objet JSON. Les champs supplémentaires dépendent du modèle et du format.

textstring

Le texte traduit en anglais.

Pour le format verbose_json, la réponse inclut également :

languagestring

Indication de langue fournie dans la réponse, lorsqu’elle est présente.

durationnumber

La durée de l'audio d'entrée en secondes.

segmentsarray

Segments du texte traduit avec horodatages.

Requête

curl -X POST "https://api.tokenlab.sh/v1/audio/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@german_audio.mp3" \
  -F "model=whisper-1"

Réponse

{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}

Traduction vs Transcription

FonctionnalitéTraductionTranscription
Langue de sortieToujours l'anglaisIdentique à l'entrée
Cas d'usageConvertir un audio étranger en anglaisPréserver la langue d'origine
Paramètre de langueNon applicableIndice facultatif

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

En-têtes

X-TokenLab-Delivery-Policy?string

Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.

Valeurs possibles

  • "auto"
  • "verified"
  • "official"

Corps de la requête

multipart/form-data

Réponse

application/json

application/json

application/json

application/json

application/json

application/json

Créer une transcription

Précédent

Realtime WebSocket

Suivant