TokenLab
Obtener clave API
DocumentaciónReferencia APIIntegraciones

Texto

Crear traducción

Traduce texto a un idioma de destino

POST
/v1/translations

Resumen

Usa /v1/translations para la traducción de texto a texto.

Este endpoint es distinto de traducción de audio, que acepta un archivo de audio y siempre devuelve texto en inglés.

Para flujos de agente, descubre primero los modelos de traducción recomendados actuales:

curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"

Luego envía explícitamente el modelo elegido a /v1/translations.

recommended_for=translation se aplica solo a la traducción de texto (POST /v1/translations). No se aplica a traducción de audio.

Cuerpo de la solicitud

modelstringobligatorio

ID del modelo de traducción devuelto por /v1/models?recommended_for=translation.

textstringobligatorio

Texto de origen que se va a traducir.

target_languagestringobligatorio

Código del idioma de destino o nombre del idioma, según el soporte del modelo.

source_languagestring

Sugerencia opcional del idioma de origen.

mime_typestringpredeterminado: text/plain

Formato del texto de origen. Valores admitidos: text/plain, text/html.

userstring

Identificador opcional del usuario final para monitorización de abuso y trazabilidad de la solicitud.

Respuesta

textstring

Texto traducido.

modelstring

Modelo que generó la traducción.

source_languagestring | null

Idioma de origen detectado o aceptado por el modelo.

target_languagestring

Idioma de destino usado para la solicitud.

Solicitud

curl -X POST "https://api.tokenlab.sh/v1/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-translation",
    "text": "你好，欢迎使用 TokenLab。",
    "target_language": "en"
  }'

Respuesta

Response
{
  "text": "Hello, welcome to TokenLab.",
  "model": "doubao-seed-translation",
  "source_language": "zh",
  "target_language": "en"
}

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

application/json

Respuesta

application/json

application/json

application/json

application/json

application/json

application/json

Evaluar decisiones

Anterior

Subir Archivo

Siguiente