Translation Task API

Vytvořit překladovou úlohu

POST/v1/translation/create

Vytvořit novou úlohu překladu pro překlad dokumentu/souboru.

Úplná adresa: https://dltranslator.com/api/v1/translation/create
Ověření: V hlavičce požadavku Authorization je nutné předat API Key
Content-Type: multipart/form-data
Chybný formát: { "error": "Invalid API key." }

Upozornění

Vytvoření úkolu bude okamžitě zařazeno do čekací fronty a vrátí taskId. Následně lze prostřednictvím rozhraní pro dotazování úkolu získat průběh, náklady a odkaz ke stažení.

Zůstatek bodů na účtu musí být alespoň 2 credits pro vytvoření úkolu. Pokud je preview nastaveno na true, vygeneruje se pouze náhled a zaplatí se body za náhled.

Parametr glossary vyhledává podle názvu glosáře, je možné opakovaně předat více polí se stejným názvem pro určení více glosářů.

Pří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'

Parametry požadavku

Parametry	Typ	Výchozí	Popis	Příklad
*file	binary	-	Soubor určený k překladu Podporované typy souborů: dotaz	bitcoin.pdf
*fromLang	String	-	Zdrojový jazyk, zdrojový jazyk nemůže být stejný jako cílový jazyk Podporované jazyky: dotaz	English
*toLang	String	-	Cílový jazyk, cílový jazyk nemůže být stejný jako zdrojový jazyk Podporované jazyky: dotaz	Simplified Chinese
model	String	-	AI model pro překlad Podporované modely: dotaz	-
fileDescription	String	-	Popis dokumentu - zlepšuje kvalitu překladu poskytnutím dodatečných informací, například přidáním kontextových informací o dokumentu a dalších překladových požadavků atd.	-
glossary	String	-	Název glosáře použitý při překladu	-
preview	Boolean	false	Generovat pouze náhled. Při generování pouze náhledu zaplaťte 2 kredity za vytvoření náhledu překladu dokumentu	-
shouldTranslateImage	Boolean	false	Zda překládat obrázky v dokumentu Podporuje pouze PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF	-
forceOCR	Boolean	false	Vynutit použití OCR pro rozpoznání obsahu dokumentu. Po zapnutí bude zároveň aktivován překlad obrázků.	-
shouldTranslateFileName	Boolean	true	Zda překládat názvy souborů	-
strictSourceLanguageCheck	Boolean	false	Zda překládat pouze text rozpoznaný jako původní jazyk. Po zapnutí se obsah v jiném než zdrojovém jazyce filtruje přísněji a při výpočtu nákladů se také použije přísnější koeficient.	-
outputFormat	String	-	Výstupní formát. Při předání MD se pokusí vygenerovat překlad v Markdownu.	MD
bilingualMode	String	Horizontal	Směr rozložení dvojjazyčného souboru. Horizontal znamená srovnání vlevo-vpravo, Vertical znamená srovnání nahoře-dole.	Horizontal
password	String	-	Heslo pro otevření PDF souboru	-
ignoreComments	Boolean	false	Zda ignorovat komentáře v souborech DOCX, PPTX a XLSX	-
ignoreNotes	Boolean	false	Zda ignorovat poznámky prezentací PPTX	-
ignoreHeadersAndFooters	Boolean	false	Zda ignorovat zápatí a záhlaví dokumentů DOCX	-
ignoreHidden	Boolean	false	Zda ignorovat skryté snímky PPTX	-
ignoreMasters	Boolean	false	Zda ignorovat text předloh PPTX	-
ignoreSheetNames	Boolean	false	Zda nepřekládat názvy listů XLSX	-
extractTextRegExpPattern	String	-	Překládá pouze obsah odpovídající regulárnímu výrazu a nahrazuje jej překladem Podporuje pouze txmsg	-
extractTextRegExpFlags	String	-	Příznaky regulárních výrazů: g, s, m, u, y Podporuje pouze txmsg	-
allowFlip	Boolean	true	Zda povolit překlopení rozvržení stránky pro jazyky se zápisem zprava doleva. Při předání hodnoty false se zároveň vypne překlopení obrázků.	-
allowFlipImage	Boolean	true	Zda povolit překlopení obsahu obrázku pro jazyky se zápisem zprava doleva.	-
webhookUrl	String	-	URL zpětného volání pro aktualizaci stavu, obsah zpětného volání zahrnuje: {taskId, progress, status}	-

Odpověď

Parametry	Typ	Výchozí	Popis	Příklad
taskId	String	-	ID úlohy	-

Běž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.