API de Tarefa de Tradução

Criar Tarefa de Tradução

POST/v1/translation/create

Criar uma nova tarefa de tradução para tradução de documento/ficheiro.

Endereço completo: https://otranslator.com/api/v1/translation/create
Autenticação: É necessário transmitir a API Key no cabeçalho de pedido Authorization
Content-Type: multipart/form-data
Formato incorreto: { "error": "Invalid API key." }

Precauções

A criação de uma tarefa entra imediatamente na fila de espera e retorna o taskId. Posteriormente, é possível obter o progresso, as despesas e a ligação de download através da interface de consulta de tarefas.

O saldo de créditos da conta deve ter pelo menos 2 credits para criar uma tarefa. Quando preview for true, apenas gera a pré-visualização e paga os créditos de pré-visualização.

O parâmetro glossary faz correspondência pelo nome do glossário e pode ser passado várias vezes com múltiplos campos do mesmo nome para especificar vários glossários.

Exemplo

curl

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

Parâmetros do Pedido

Parâmetros	Tipo	Predefinição	Descrição	Exemplo
*file	binary	-	Ficheiro a ser traduzido Tipos de ficheiro suportados: consultar	bitcoin.pdf
*fromLang	String	-	Idioma de origem, o idioma de origem não pode ser igual ao idioma de destino Idiomas suportados: consultar	English
*toLang	String	-	Idioma de destino, o idioma de destino não pode ser igual ao idioma original Idiomas suportados: consultar	Simplified Chinese
model	String	-	Modelo de IA para tradução Modelos suportados: consultar	-
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.	-
glossary	String	-	Nome do glossário de terminologia utilizado na tradução	-
preview	Boolean	false	Se gerar apenas pré-visualização. Ao gerar apenas pré-visualização, pagar 2 credits para gerar a pré-visualização da tradução do documento	-
shouldTranslateImage	Boolean	false	Se deve traduzir imagens no documento Suporta apenas PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Forçar utilização de OCR para reconhecer conteúdo do documento. Ao ativar, também ativará a tradução de imagens.	-
shouldTranslateFileName	Boolean	true	Traduzir nome do ficheiro	-
strictSourceLanguageCheck	Boolean	false	Traduzir apenas o texto identificado como idioma de origem. Ao ativar, filtra mais rigorosamente o conteúdo que não seja do idioma de origem e o cálculo de custos utilizará também um coeficiente mais rigoroso.	-
outputFormat	String	-	Formato de saída. Ao passar MD, tentará gerar tradução em Markdown.	MD
bilingualMode	String	Horizontal	Direção de disposição do ficheiro bilingue. Horizontal indica comparação esquerda-direita, Vertical indica comparação cima-baixo.	Horizontal
password	String	-	Palavra-passe de abertura do ficheiro PDF	-
ignoreComments	Boolean	false	Ignorar anotações em DOCX, PPTX e XLSX	-
ignoreNotes	Boolean	false	Ignorar notas de PPTX	-
ignoreHeadersAndFooters	Boolean	false	Ignorar rodapés e cabeçalhos de DOCX	-
ignoreHidden	Boolean	false	Ignorar diapositivos ocultos de PPTX	-
ignoreMasters	Boolean	false	Ignorar texto modelo de PPTX	-
ignoreSheetNames	Boolean	false	Se não traduzir os nomes das folhas XLSX	-
extractTextRegExpPattern	String	-	Traduz apenas o conteúdo que corresponda à expressão regular e substitui-o pela tradução Suporta apenas txmsg	-
extractTextRegExpFlags	String	-	Flags de expressões regulares: g, s, m, u, y Suporta apenas txmsg	-
allowFlip	Boolean	true	Se deve permitir a inversão do layout da página para idiomas da direita para a esquerda. Ao definir como false, a inversão de imagem também será desativada.	-
allowFlipImage	Boolean	true	Se deve permitir a inversão do conteúdo da imagem para idiomas da direita para a esquerda.	-
webhookUrl	String	-	URL de callback para actualizações de estado, o conteúdo do callback inclui: {taskId, progress, status}	-

Resposta

Parâmetros	Tipo	Predefinição	Descrição	Exemplo
taskId	String	-	ID da Tarefa	-

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 create the task.

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 Invalid fromLang: [language]. Use a language returned by /api/v1/languages.

The provided source language is not supported.

400 Invalid toLang: [language]. Use a language returned by /api/v1/languages.

The provided target language is not supported.

400 Missing required file upload: file.

Upload the source document in the file form field.

404 Glossary "[name]" not found.

The specified glossary does not exist or does not belong to the current API account.