Texto

Criar tradução

Traduz texto para um idioma de destino

POST
/v1/translations

Visão geral

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 gera texto em inglês.

Use a API Models para obter os modelos atuais de tradução de texto:

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

Em seguida, envie explicitamente o modelo escolhido para /v1/translations.

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

Corpo da requisição

modelstringobrigatório

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

textstringobrigatório

Texto de origem a ser traduzido. O limite de tamanho de entrada depende do modelo; consulte max_input_tokens em GET /v1/models/{model}.

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: text/plain ou text/html. Envie-o apenas quando os detalhes do modelo listarem mime_type.

userstring

Identificador opcional do usuário final para monitoramento de abusos e rastreamento de requisições. Envie-o apenas quando os detalhes do modelo listarem user.

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 para a 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"
}

Erros

StatusCódigoCausa
400invalid_requestmodel, text ou target_language está ausente ou vazio, ou mime_type não é um dos dois valores válidos. param indica o nome do campo
400unsupported_endpointO modelo não está publicado para este endpoint

Trate outros status conforme descrito em Tratar erros de API.

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