Přeskočit na obsah

Vytvořte úlohu překladu

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
PolíčkoTypVyžadovánoVýchozíPopis
document_idřetězec✅—ID potvrzeného dokumentu
target_langřetězec✅—Kód cílového jazyka
source_langřetězec—Automatická detekceKód zdrojového jazyka
engineřetězec—xr-397bID nastavení překladu, viz nastavení překladů
output_modeřetězec—bilingualsingle nebo bilingual
glossary_idřetězec——ID glosáře tohoto účtu. Glosáře jsou určeny pro placené účty (alespoň jedna úspěšná platba); neuhrazený účet, který odeslal jednu platbu, dostane 403
include_imagesboolean—falseTaké přeložte text na obrázcích v dokumentu.
context_translationboolean—falseZapněte vylepšení kontextu
style_presetřetězec——Přednastavení stylu

Vytvořená úloha je vložena do fronty. Každé konto zpracovává najednou až 5 souborů; další úlohy jsou stále vytvářeny a fronta se automaticky plní, přičemž nové úlohy jsou spouštěny po dokončení předchozích. Zatímco úloha čeká, její stage_message uvádí, kolik úloh je před ní.

Před zahájením úlohy je zůstatek zkontrolován vzhledem k hranici: PDF vyžaduje zůstatek nad “strany × 2 kredity”; ostatní formáty se řídí délkou zdrojového textu, minimálně 2 kredity. Pokud zůstatek nedokáže spustit soubor, tato úloha končí s status=failed a quota_exceeded=true, nejsou účtovány žádné poplatky a ostatní úlohy nejsou ovlivněny. Po dokončení úlohy je účtováno skutečné využití; pokud náklady překročí zůstatek, zůstatek se stane záporným, později přijaté kredity nejprve splatí dluh a nové úlohy nelze spustit, dokud je zůstatek záporný, proto doplňte zůstatek. Viz kredity a využití .

Terminál
curl --fail-with-body -X POST https://omnidoc.top/api/v1/jobs \
-H "X-API-Key: $OMNIDOC_API_KEY" \
-H "Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f" \
-H "Content-Type: application/json" \
-d '{"document_id":"4q8mx2q9z1k7p6ra","target_lang":"en"}'

Odpověď 201 (serverova stage_message je v čínštině):

{
"id": "q3f8s6c2a9m1k4tx",
"document_id": "4q8mx2q9z1k7p6ra",
"source_lang": null,
"target_lang": "en",
"engine": "xr-397b",
"status": "pending",
"stage": "queued",
"stage_progress": 0,
"stage_message": "排队中",
"time_cost": 0,
"error_msg": null,
"quota_exceeded": false,
"queue_position": null,
"created_at": "2026-10-01T12:01:00Z",
"updated_at": "2026-10-01T12:01:00Z"
}
StavPříčina
403Klíč nepovoluje zvolené nastavení, nebo byl odeslán neuhrazený účet glossary_id
404Dokument nebo slovník neexistuje, byl smazán nebo patří jinému účtu.
415Formát souboru nelze přeložit.
422Soubor je prázdný, neobsahuje žádný překládaný text nebo je parametr neplatný.
429Příliš mnoho požadavků nebo plná fronta; zkuste to znovu po Retry-After

Idempotency-Key je volitelný, ale doporučuje se pro každé předání. Klíč je složen z 1–128 viditelných znaků ASCII a zůstává platný na neurčito pro stejné přihlašovací údaje:

  • Stejný klíč, stejná tělesná část: vrátí se původní úloha (včetně té neúspěšné); nic není vytvořeno ani zpoplatněno dvakrát.
  • Stejný klíč, jiné tělo: 409 (idempotency_request_conflict).
  • Původní úloha byla smazána: 410 (idempotency_job_gone).

Pro každé nové odeslání používejte nový UUID a původní klíč použijte znovu pouze při opakovaném pokusu o odeslání stejného odeslání.