Criar tradução

Criar uma tarefa de tradução.

1curl -X POST 'https://otranslator.com/api/v1/translation/create' \
2--header 'Authorization: [yourSecretKey]' \
3--form 'fromLang=English' \
4--form 'toLang=Simplified Chinese' \
5--form 'glossary=[GlossaryName]' \
6--form 'file=@bitcoin.pdf'

Parâmetros de pedido

Idiomas suportados:
English、Simplified Chinese、Traditional Chinese (Hong Kong)、Traditional Chinese (Taiwan)、Traditional Chinese、British English、Spanish、Portuguese、Russian、Italian、French、German、Ukrainian、Swedish、Japanese、Japanese (Honorifics)、Japanese (Humble)、Japanese (Polite)、Polish、Turkish、Korean、Malay、Lao、Thai、Vietnamese、Bengali、Burmese、Finnish、Georgian、Greek、Albanian、Arabic、Armenian、Azerbaijani、Belarusian、Bosnian、Bulgarian、Canadian French、Catalan、Croatian、Czech、Danish、Dutch、Estonian、Filipino、Gujarati、Haitian Creole、Hebrew、Hindi、Hungarian、Icelandic、Indonesian、Javanese、Irish、Kazakh、Khmer、Latin、Latin American Spanish、Brazilian Portuguese、Latvian、Lithuanian、Macedonian、Maltese、Mongolian (Cyrillic)、Montenegrin、Norwegian、Persian、Romanian、Serbian (Cyrillic letters)、Serbian (Latin letters)、Sinhala、Slovak、Slovenian、Swahili、Tamil、Telugu、Oriya、Kannada、Punjabi、Marathi、Malayalam、Uzbek、Urdu、Amharic、Uyghur、Cantonese、Yiddish、Tigrinya、Turkmen (Latin letters)、Turkmen (Cyrillic letters)、Any Language

Parâmetros	Tipo	Descrição
*fromLang	String	Idioma de origem, o idioma de origem não pode ser igual ao idioma de destino, consulte os idiomas suportados
*toLang	String	Idioma de destino, o idioma de destino não pode ser igual ao idioma de origem, consulte os idiomas suportados
*model	String	Modelos disponíveis: gemini-2.0-flash \| gemini-pro \| gemini-2.5-pro \| claude-haiku \| claude-3.7-sonnet \| gpt-4.1-mini \| gpt-4.1 \| o4-mini \| deepseek-v3 \| deepseek-r1 \| grok-3-mini \| grok-3 \| llama-4-maverick
*file	binary	Documentos que precisam de tradução,Tipos de ficheiros suportados: .PDF .DOCX .XLSX .PPTX .EPUB .PO .SRT .TXT .HTML .ZIP .XML .XLF .GO .JPG .JPEG .PNG .MD .ODT .ODS .ODP .CSV .TSV .YAML .PHP .AI
shouldTranslateImage	String	Valores válidos: "true" ou "false". Se as imagens no documento PDF devem ser traduzidas, o valor predefinido é false
glossary	String	Nome do glossário de terminologia utilizado na tradução
preview	String	Valores válidos: "true" ou "false". Gerar uma pré-visualização da tradução do documento pagando 2 credits

Resposta

Parâmetros	Tipo	Descrição
taskId	String	ID da tarefa criada

Consultar tradução

Consultar tarefas de tradução, incluindo o estado da tarefa e ligações para ficheiros traduzidos

1curl -X POST 'https://otranslator.com/api/v1/translation/query' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data  '{ "taskId": "[created taskId]" }'

Parâmetros de pedido

Parâmetros	Tipo	Descrição
*taskId	String	ID da tarefa de tradução

Resposta

Parâmetros	Tipo	Descrição
status	String	'Waiting' \| 'Processing' \| 'Completed' \| 'Terminated'
progress	integer	0~100, Progresso da tarefa de tradução
translatedFileUrl	String	Link para descarregar o ficheiro de tradução, válido apenas quando a tradução estiver concluída (status = 'Completed')
translatedBilingualFileUrl	String	O link para descarregar o ficheiro bilingue traduzido só está disponível quando a tradução estiver concluída (status = 'Completed')
usedCredits	integer	Créditos utilizados para tradução
tokenCount	integer	Número de Tokens correspondentes ao texto no documento
glossary	String[]	Nome do glossário utilizado no documento

Eliminar tradução

Eliminar tarefas de tradução e documentos relacionados. As tarefas de tradução criadas por API serão automaticamente eliminadas após 7 dias.

1curl -X POST 'https://otranslator.com/api/v1/translation/delete' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data  '{ "taskId": "[created taskId]" }'

Parâmetros de pedido

Parâmetros	Tipo	Descrição
*taskId	String	ID da tarefa de tradução que precisa de eliminação