Audio & temps réel
Créer une traduction
Traduit un fichier audio en texte anglais
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.
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.
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.
Un texte optionnel pour guider le style du modèle ou poursuivre un segment précédent. Doit être en anglais.
jsonFormat 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.
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.
Le texte traduit en anglais.
Pour le format verbose_json, la réponse inclut également :
Libellé de la langue indiqué dans la réponse, lorsqu'il est fourni.
La durée du fichier audio d'entrée en secondes.
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é | Traduction | Transcription |
|---|---|---|
| Langue de sortie | Toujours en anglais | Identique à l'entrée |
| Cas d'usage | Convertir un audio étranger en anglais | Conserver la langue d'origine |
| Paramètre de langue | Non applicable | Indication optionnelle |
Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
En-têtes
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