Audio y tiempo real
Crear traducción
Traduce audio a texto en inglés
Resumen
Traduce audio en cualquier idioma compatible a texto en inglés. A diferencia de la transcripción, este endpoint siempre devuelve texto en inglés independientemente del idioma de entrada.
Este endpoint traduce audio al inglés. No envíes language: la traducción de audio no admite este parámetro y puede devolver unsupported_parameter. Para traducir texto, usa POST /v1/translations; recommended_for=translation se refiere a esa API de texto.
Cuerpo de la solicitud
La respuesta llega cuando termina la traducción. Para audio largo, permite un tiempo de espera HTTP de al menos 120s.
El archivo de audio a traducir. Formatos compatibles: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. El tamaño máximo del archivo es de 25 MB.
whisper-1ID del modelo de traducción de audio, como whisper-1. Confirma en sus detalles actuales que admite POST /v1/audio/translations.
Un texto opcional para guiar el estilo del modelo o continuar un segmento anterior. Debe estar en inglés.
jsonFormato de salida. Whisper admite json, text, srt, verbose_json y vtt; otros modelos pueden admitir un conjunto distinto. Consulta los detalles del modelo.
Temperatura de muestreo de 0 a 1, solo para modelos compatibles con este parámetro.
Respuesta
Los campos siguientes describen respuestas JSON de transcripción o traducción. text, srt y vtt devuelven texto o subtítulos sin envolverlos en JSON. Los campos adicionales dependen del modelo y del formato.
El texto traducido en inglés.
Para el formato verbose_json, la respuesta también incluye:
Etiqueta de idioma incluida en la respuesta, cuando se proporciona.
La duración del audio de entrada en segundos.
Segmentos del texto traducido con marcas de tiempo.
Solicitud
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"Respuesta
{
"text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}Traducción vs Transcripción
| Característica | Traducción | Transcripción |
|---|---|---|
| Idioma de salida | Siempre inglés | Igual que la entrada |
| Caso de uso | Convertir audio en otro idioma a inglés | Preservar el idioma original |
| Parámetro de idioma | No aplicable | Pista opcional |
Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Encabezados
Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.
Valores permitidos
- "auto"
- "verified"
- "official"
Cuerpo de la solicitud
multipart/form-data
Respuesta
application/json
application/json
application/json
application/json
application/json
application/json