Texto
Criar tradução
Traduz texto para um idioma de destino
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
ID do modelo de tradução retornado por /v1/models?recommended_for=translation.
Texto de origem a ser traduzido. O limite de tamanho de entrada depende do modelo; consulte max_input_tokens em GET /v1/models/{model}.
Código do idioma de destino ou nome do idioma, dependendo do suporte do modelo.
Dica opcional do idioma de origem.
text/plainFormato do texto de origem: text/plain ou text/html. Envie-o apenas quando os detalhes do modelo listarem mime_type.
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
Texto traduzido.
Modelo que gerou a tradução.
Idioma de origem detectado ou aceito pelo modelo.
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
{
"text": "Hello, welcome to TokenLab.",
"model": "doubao-seed-translation",
"source_language": "zh",
"target_language": "en"
}Erros
| Status | Código | Causa |
|---|---|---|
400 | invalid_request | model, 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 |
400 | unsupported_endpoint | O modelo não está publicado para este endpoint |
Trate outros status conforme descrito em Tratar erros de API.
Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Cabeçalhos
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