Audio y tiempo real

Crear traducción

Traduce audio a texto en inglés

POST
/v1/audio/translations

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.

filefileobligatorio

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.

modelstringobligatorio

Ningún modelo público declara actualmente compatibilidad con POST /v1/audio/translations; no hay un ID de modelo predeterminado ni disponible para copiar.

promptstring

Un texto opcional para guiar el estilo del modelo o continuar un segmento anterior. Debe estar en inglés.

response_formatstringpredeterminado: json

Formato de salida. Los valores aceptados dependen del modelo; consulte sus detalles. text devuelve texto sin formato en lugar de un objeto JSON.

temperaturenumber

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.

textstring

El texto traducido en inglés.

Para el formato verbose_json, la respuesta también incluye:

languagestring

Etiqueta de idioma reportada en la respuesta, cuando se proporciona.

durationnumber

La duración del audio de entrada en segundos.

segmentsarray

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ísticaTraducciónTranscripción
Idioma de salidaSiempre inglésEl mismo que el de entrada
Caso de usoConvertir audio en idioma extranjero a inglésConservar el idioma original
Parámetro de idiomaNo aplicableIndicio opcional

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Encabezados

X-TokenLab-Delivery-Policy?string

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