Translation Task API

Vytvoriť prekladovú úlohu

POST/v1/translation/create

Vytvorte novú úlohu prekladu pre preklad dokumentov/súborov.

Úplná adresa: https://dltranslator.com/api/v1/translation/create
Autentifikácia: Je potrebné poskytnúť API Key v hlavičke požiadavky Authorization
Content-Type: multipart/form-data
Chybný formát: { "error": "Invalid API key." }

Upozornenia

Vytvorenie úlohy ju okamžite zaradí do čakacej fronty a vráti taskId. Následne je možné prostredníctvom rozhrania na dotazovanie úloh získať pokrok, náklady a odkaz na stiahnutie.

Zostatok kreditov na účte musí byť aspoň 2 credits, aby bolo možné vytvoriť úlohu. Keď je preview true, vygeneruje sa iba náhľad a zaplatia sa kredity za náhľad.

Parameter glossary sa zhoduje podľa názvu glosára, je možné opakovane zadať viacero polí s rovnakým názvom na určenie viacerých glosárov.

Príklad

curl

1curl -X POST 'https://dltranslator.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'

Parametre požiadavky

Parametre	Typ	Predvolené	Popis	Príklad
*file	binary	-	Súbor určený na preklad Podporované typy súborov: dotaz	bitcoin.pdf
*fromLang	String	-	Zdrojový jazyk, zdrojový jazyk nemôže byť rovnaký ako cieľový jazyk Podporované jazyky: dotaz	English
*toLang	String	-	Cieľový jazyk, cieľový jazyk nemôže byť rovnaký ako zdrojový jazyk Podporované jazyky: dotaz	Simplified Chinese
model	String	-	AI model pre preklad Podporované modely: dotaz	-
fileDescription	String	-	Popis dokumentu, zlepšenie kvality prekladu poskytnutím dodatočných informácií, napríklad pridanie kontextových informácií o dokumente a ďalších požiadaviek na preklad atď.	-
glossary	String	-	Názov terminologického glosára použitého pri preklade	-
preview	Boolean	false	Či generovať iba náhľad. Pri generovaní iba náhľadu sa za 2 kredity vygeneruje náhľad prekladu dokumentu	-
shouldTranslateImage	Boolean	false	Určuje, či sa majú prekladať obrázky v dokumente Podporuje iba PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Či vynútiť používanie OCR na rozpoznanie obsahu dokumentu. Po zapnutí sa zároveň aktivuje preklad obrázkov.	-
shouldTranslateFileName	Boolean	true	Preložiť názvy súborov	-
strictSourceLanguageCheck	Boolean	false	Či preložiť iba text rozpoznaný ako pôvodný jazyk. Po zapnutí sa prísnejšie filtruje obsah, ktorý nie je v zdrojovom jazyku, a výpočet nákladov použije prísnejší koeficient.	-
outputFormat	String	-	Výstupný formát. Pri zadaní MD sa pokúsi vygenerovať preklad v Markdown.	MD
bilingualMode	String	Horizontal	Smer usporiadania dvojjazyčného súboru. Horizontal znamená zobrazenie vľavo-vpravo, Vertical znamená zobrazenie hore-dole.	Horizontal
password	String	-	Heslo na otvorenie PDF súboru	-
ignoreComments	Boolean	false	Ignorovať komentáre v súboroch DOCX, PPTX a XLSX	-
ignoreNotes	Boolean	false	Ignorovať poznámky v súboroch PPTX	-
ignoreHeadersAndFooters	Boolean	false	Ignorovať zápatia a hlavičky v súboroch DOCX	-
ignoreHidden	Boolean	false	Ignorovať skryté snímky v súboroch PPTX	-
ignoreMasters	Boolean	false	Ignorovať text predlohy v súboroch PPTX	-
ignoreSheetNames	Boolean	false	Či neprekladať názvy hárkov v XLSX súboroch	-
extractTextRegExpPattern	String	-	Prekladá iba obsah zodpovedajúci regulárnemu výrazu a nahrádza ho prekladom Podporuje iba formát txmsg	-
extractTextRegExpFlags	String	-	Príznaky regulárnych výrazov: g, s, m, u, y Podporuje iba txmsg	-
allowFlip	Boolean	true	Či povoliť prevracanie rozloženia stránky pre jazyky písané sprava doľava. Nastavením na false sa zároveň vypne prevracanie obrázkov.	-
allowFlipImage	Boolean	true	Či povoliť prevracanie obsahu obrázkov pre jazyky písané sprava doľava.	-
webhookUrl	String	-	URL adresa pre spätné volanie pri aktualizácii stavu, obsah spätného volania obsahuje: {taskId, progress, status}	-

Odpoveď

Parametre	Typ	Predvolené	Popis	Príklad
taskId	String	-	ID úlohy	-

Bežné chyby

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.