Audio y tiempo real
Crear traducción
Traduce audio a texto en inglés
Descripción general
Traduce audio en cualquier idioma compatible a texto en inglés. A diferencia de la transcripción, este endpoint siempre genera texto en inglés independientemente del idioma de entrada.
Este endpoint traduce audio al inglés. No envíe language; no es compatible con la traducción de audio y puede devolver unsupported_parameter. Para la traducción de texto, utilice POST /v1/translations; recommended_for=translation hace referencia a esa API de texto.
Cuerpo de la solicitud
La traducción se devuelve cuando finaliza el procesamiento. Para audios más largos, configure un tiempo de espera (timeout) del cliente 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 de archivo es de 25 MB.
Ningún modelo público declara actualmente compatibilidad con POST /v1/audio/translations; no hay un ID de modelo predeterminado ni disponible para copiar.
Un texto opcional para guiar el estilo del modelo o continuar un segmento anterior. Debe estar en inglés.
jsonFormato de salida. Los valores aceptados dependen del modelo; consulte sus detalles. text devuelve texto sin formato en lugar de un objeto JSON.
Temperatura de muestreo de 0 a 1, solo para modelos que incluyan este parámetro.
Respuesta
Los campos a continuación describen las respuestas de transcripción o traducción en JSON. text, srt y vtt devuelven texto sin formato o subtítulos en lugar de un objeto JSON. Los campos adicionales dependen del modelo y del formato de salida.
El texto traducido en inglés.
Para el formato verbose_json, la respuesta también incluye:
Etiqueta de idioma reportada 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 "model=your-model-id" \
-F "file=@german_audio.mp3"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 | El mismo que el de entrada |
| Caso de uso | Convertir audio en idioma extranjero a inglés | Conservar el idioma original |
| Parámetro de idioma | No aplicable | Indicio 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