Texto

Crear traducción

Traduce texto a un idioma de destino

POST
/v1/translations

Descripción general

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

Este endpoint es diferente de Traducción de audio, el cual acepta un archivo de audio y siempre genera texto en inglés.

Usa la Models API para obtener los modelos actuales de traducción de texto:

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 únicamente a la traducción de texto (POST /v1/translations). No se aplica a la 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 a traducir. El límite de longitud de entrada depende del modelo; consulta max_input_tokens en GET /v1/models/{model}.

target_languagestringobligatorio

Código de idioma o nombre del idioma de destino, según la compatibilidad del modelo.

source_languagestring

Indicación opcional del idioma de origen.

mime_typestringpredeterminado: text/plain

Formato del texto de origen: text/plain o text/html. Envíalo solo cuando los detalles del modelo indiquen mime_type.

userstring

Identificador opcional de usuario final para monitoreo de abusos y rastreo de solicitudes. Envíalo solo cuando los detalles del modelo indiquen user.

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 utilizado 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"
}

Errores

EstadoCódigoCausa
400invalid_requestmodel, text o target_language faltan o están vacíos, o mime_type no es uno de los dos valores. param indica el campo
400unsupported_endpointEl modelo no está publicado para este endpoint

Maneja otros estados como se describe en Manejar errores de la API.

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