Texto

Criar tradução

Traduz texto para um idioma de destino

POST
/v1/translations

Resumo

Use /v1/translations para tradução de texto para texto.

Este endpoint é diferente de tradução de áudio, que aceita um arquivo de áudio e sempre produz texto em inglês.

Para fluxos de agente, descubra primeiro os modelos de tradução recomendados atuais:

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

Depois envie explicitamente o modelo escolhido para /v1/translations.

recommended_for=translation se aplica apenas à tradução de texto (POST /v1/translations). Ele não se aplica a tradução de áudio.

Corpo da solicitação

modelstringobrigatório

ID do modelo de tradução retornado por /v1/models?recommended_for=translation.

textstringobrigatório

Texto de origem a ser traduzido.

target_languagestringobrigatório

Código do idioma de destino ou nome do idioma, dependendo do suporte do modelo.

source_languagestring

Dica opcional do idioma de origem.

mime_typestringpadrão: text/plain

Formato do texto de origem. Valores suportados: text/plain, text/html.

userstring

Identificador opcional do usuário final para monitoramento de abuso e rastreamento da requisição.

Resposta

textstring

Texto traduzido.

modelstring

Modelo que gerou a tradução.

source_languagestring | null

Idioma de origem detectado ou aceito pelo modelo.

target_languagestring

Idioma de destino usado na requisição.

Requisição

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

Resposta

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

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Cabeçalhos

X-TokenLab-Delivery-Policy?string

Política de entrega por solicitação. Substitui os padrões da API key e do Workspace. Tenta automaticamente o TokenLab Verified primeiro e pode alternar uma vez para Official apenas antes da saída, aceitação da solicitação ou criação de recurso persistente.

Valores permitidos

  • "auto"
  • "verified"
  • "official"

Corpo da requisição

application/json

Resposta

application/json

application/json

application/json

application/json

application/json

application/json