TokenLab

Audio & temps réel

Créer une traduction

Traduit un fichier audio en texte anglais

POST
/v1/audio/translations

Vue d'ensemble

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

Ce endpoint traduit l'audio en anglais. N'envoyez pas language ; ce paramètre n'est pas pris en charge pour la traduction audio et peut renvoyer unsupported_parameter. Pour la traduction de texte, utilisez POST /v1/translations ; recommended_for=translation fait référence à cette API de texte.

Corps de la requête

La traduction est renvoyée lorsque le traitement est terminé. Pour les fichiers audio plus longs, prévoyez un délai d'expiration du client 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 Mo.

modelstringrequis

Aucun modèle public ne déclare actuellement de prise en charge pour POST /v1/audio/translations ; il n'y a pas d'ID de modèle par défaut ou copiable.

promptstring

Un texte optionnel 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. Les valeurs acceptées dépendent du modèle ; vérifiez ses détails. text renvoie du texte brut au lieu d'un objet JSON.

temperaturenumber

Température d'échantillonnage de 0 à 1, uniquement pour les modèles qui listent ce paramètre.

Réponse

Les champs ci-dessous décrivent les réponses JSON de transcription ou de traduction. text, srt et vtt renvoient du texte brut ou des sous-titres plutôt qu'un objet JSON. Les champs supplémentaires dépendent du modèle et du format de sortie.

textstring

Le texte traduit en anglais.

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

languagestring

Libellé de la langue indiqué dans la réponse, lorsqu'il est fourni.

durationnumber

La durée du fichier 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 "model=your-model-id" \
  -F "file=@german_audio.mp3"

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 en anglaisIdentique à l'entrée
Cas d'usageConvertir un audio étranger en anglaisConserver la langue d'origine
Paramètre de langueNon applicableIndication optionnelle

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