Texto
Crear traducción
Traduce texto a un idioma de destino
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
ID del modelo de traducción devuelto por /v1/models?recommended_for=translation.
Texto de origen a traducir. El límite de longitud de entrada depende del modelo; consulta max_input_tokens en GET /v1/models/{model}.
Código de idioma o nombre del idioma de destino, según la compatibilidad del modelo.
Indicación opcional del idioma de origen.
text/plainFormato del texto de origen: text/plain o text/html. Envíalo solo cuando los detalles del modelo indiquen mime_type.
Identificador opcional de usuario final para monitoreo de abusos y rastreo de solicitudes. Envíalo solo cuando los detalles del modelo indiquen user.
Respuesta
Texto traducido.
Modelo que generó la traducción.
Idioma de origen detectado o aceptado por el modelo.
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
{
"text": "Hello, welcome to TokenLab.",
"model": "doubao-seed-translation",
"source_language": "zh",
"target_language": "en"
}Errores
| Estado | Código | Causa |
|---|---|---|
400 | invalid_request | model, text o target_language faltan o están vacíos, o mime_type no es uno de los dos valores. param indica el campo |
400 | unsupported_endpoint | El modelo no está publicado para este endpoint |
Maneja otros estados como se describe en Manejar errores de la API.
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
application/json
Respuesta
application/json
application/json
application/json
application/json
application/json
application/json