API de Tarefa de Tradução
Texto traduzido
Traduzir o texto e devolver os resultados da tradução de forma sincronizada.
- Endereço completo
- https://otranslator.com/api/v1/translation/translateTexts
- Autenticação
- É necessário transmitir a API Key no cabeçalho de pedido Authorization
- Content-Type
- application/json
- Formato incorreto
- { "error": "Invalid API key." }
Precauções
Esta interface guarda temporariamente o texto recebido como documento JSON e processa-o de forma síncrona, sendo adequada para tradução instantânea de pequenos lotes de texto.
O saldo de créditos da conta deve ter pelo menos 2 credits. Se o custo real exceder o saldo, a interface retornará taskId e price, e mostrará saldo insuficiente.
Exemplo
1curl -X POST 'https://otranslator.com/api/v1/translation/translateTexts' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "texts": [
6 "string"
7 ],
8 "fromLang": "[string]",
9 "toLang": "[string]"
10}'Parâmetros do Pedido
| Parâmetros | Tipo | Predefinição | Descrição | Exemplo |
|---|---|---|---|---|
| *texts | String[] | - | Texto a traduzir | - |
| *fromLang | String | - |
| - |
| *toLang | String | - |
| - |
| model | String | - |
| - |
| fileDescription | String | - | Descrição do documento: ao fornecer informações adicionais, melhora a qualidade da tradução, como por exemplo adicionar informações de contexto extra do documento e outros requisitos de tradução, etc. | - |
Resposta
| Parâmetros | Tipo | Predefinição | Descrição | Exemplo |
|---|---|---|---|---|
| taskId | String | - | ID da Tarefa | - |
| translatedTexts | String[] | - | Texto traduzido | - |
| price | Integer | - | Número total de Credits necessários para a tradução | - |
| usedCredits | Integer | - | Número de Credits utilizados pela tarefa de tradução | - |
Erros Comuns
401 Missing API key.
The Authorization request header is required.
401 Invalid API key.
The API key does not exist, has been deleted, or is no longer valid.
402 Insufficient credits balance.
The account does not have enough credits to translate the texts.
400 Missing required parameter: fromLang.
Provide fromLang using a language returned by /api/v1/languages.
400 Missing required parameter: toLang.
Provide toLang using a language returned by /api/v1/languages.
400 Missing required parameter: texts.
Provide a non-empty texts array.
400 Failed to translate texts.
The text translation task could not be processed.