API Sarcină de Traducere

Creare sarcină de traducere

POST/v1/translation/create

Creează o nouă sarcină de traducere pentru traducerea documentelor/fișierelor.

Adresă completă: https://otranslator.com/api/v1/translation/create
Autentificare: Este necesar să transmiteți API Key în headerul de cerere Authorization
Content-Type: multipart/form-data
Format greșit: { "error": "Invalid API key." }

Precauții

Crearea unei sarcini va fi adăugată imediat în coada de așteptare și va returna taskId. Ulterior, progresul, costul și linkul de descărcare pot fi obținute prin interfața de interogare a sarcinilor.

Soldul de credite al contului trebuie să fie de cel puțin 2 credits pentru a crea o sarcină. Când preview este true, se generează doar previzualizarea și se plătesc creditele de previzualizare.

Parametrul glossary se potrivește după numele glosarului, se pot transmite în mod repetat mai multe câmpuri cu același nume pentru a specifica mai multe glosare.

Exemplu

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'

Parametrii de Cerere

Parametri	Tip	Implicit	Descriere	Exemplu
*file	binary	-	Fișierul care necesită traducere Tipuri de fișiere suportate: interogare	bitcoin.pdf
*fromLang	String	-	Limba sursă, limba sursă nu poate fi identică cu limba țintă Limbi suportate: interogare	English
*toLang	String	-	Limba țintă, limba țintă nu poate fi identică cu limba originală Limbi suportate: interogare	Simplified Chinese
model	String	-	Modelul AI pentru traducere Modele suportate: interogare	-
fileDescription	String	-	Descrierea documentului - prin furnizarea de informații suplimentare se îmbunătățește calitatea traducerii, de exemplu prin adăugarea de informații contextuale suplimentare ale documentului și alte cerințe de traducere etc.	-
glossary	String	-	Numele glosarului utilizat pentru traducere	-
preview	Boolean	false	Să se genereze doar previzualizarea. Când se generează doar previzualizarea, prin plata a 2 credite pentru a genera previzualizarea traducerii documentului	-
shouldTranslateImage	Boolean	false	Dacă să se traducă imaginile din document Suportă exclusiv PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Forțează utilizarea OCR pentru recunoașterea conținutului documentului. După activare, va activa și traducerea imaginilor.	-
shouldTranslateFileName	Boolean	true	Să se traducă numele fișierului	-
strictSourceLanguageCheck	Boolean	false	Dacă să se traducă doar textul identificat ca fiind în limba sursă. După activare, va filtra mai riguros conținutul care nu este în limba sursă, iar calculul tarifelor va folosi de asemenea un coeficient mai riguros.	-
outputFormat	String	-	Formatul de ieșire. La transmiterea valorii MD se va încerca generarea traducerii în format Markdown.	MD
bilingualMode	String	Horizontal	Direcția de aranjare a fișierului bilingv. Horizontal înseamnă aliniere stânga-dreapta, Vertical înseamnă aliniere sus-jos.	Horizontal
password	String	-	Parola de deschidere pentru fișierul PDF	-
ignoreComments	Boolean	false	Să se ignore comentariile din fișierele DOCX, PPTX și XLSX	-
ignoreNotes	Boolean	false	Să se ignore notele din fișierele PPTX	-
ignoreHeadersAndFooters	Boolean	false	Să se ignore subsolurile și anteturile din fișierele DOCX	-
ignoreHidden	Boolean	false	Să se ignore slide-urile ascunse din fișierele PPTX	-
ignoreMasters	Boolean	false	Să se ignore textul șablon din fișierele PPTX	-
ignoreSheetNames	Boolean	false	Dacă să nu se traducă numele foilor de calcul XLSX	-
extractTextRegExpPattern	String	-	Traduce exclusiv conținutul care corespunde expresiei regulate și îl înlocuiește cu traducerea Suportă doar txmsg	-
extractTextRegExpFlags	String	-	Indicatorii expresiilor regulate: g, s, m, u, y Suportă doar txmsg	-
allowFlip	Boolean	true	Permite inversarea aspectului paginii pentru limbile de la dreapta la stânga. Transmiterea valorii false va dezactiva și inversarea imaginilor.	-
allowFlipImage	Boolean	true	Permite inversarea conținutului imaginilor pentru limbile de la dreapta la stânga.	-
webhookUrl	String	-	URL-ul de callback pentru actualizări de stare, conținutul callback-ului include: {taskId, progress, status}	-

Răspuns

Parametri	Tip	Implicit	Descriere	Exemplu
taskId	String	-	ID sarcină	-

Erori frecvente

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.