Saltar al contenido principal

​
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" \
  -H "Authorization: Bearer sk-your-api-key"
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

​
model
string
requerido
ID del modelo de traducción devuelto por /v1/models?recommended_for=translation.
​
text
string
requerido
Texto de origen que se va a traducir.
​
target_language
string
requerido
Código del idioma de destino o nombre del idioma, según el soporte del modelo.
​
source_language
string
Sugerencia opcional del idioma de origen.
​
mime_type
string
predeterminado:"text/plain"
Formato del texto de origen. Valores admitidos: text/plain, text/html.
​
user
string
Identificador opcional del usuario final para monitorización de abuso y trazabilidad de la solicitud.

​
Respuesta

​
text
string
Texto traducido.
​
model
string
Modelo que generó la traducción.
​
source_language
string | null
Idioma de origen detectado o aceptado por el modelo.
​
target_language
string
Idioma de destino usado para la 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"
  }'

from openai import OpenAI
import requests

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokenlab.sh/v1"
)

response = requests.post(
    "https://api.tokenlab.sh/v1/translations",
    headers={
        "Authorization": "Bearer sk-your-api-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "doubao-seed-translation",
        "text": "你好，欢迎使用 TokenLab。",
        "target_language": "en",
    },
    timeout=30,
)

print(response.json()["text"])

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