Vytvořte úlohu překladu
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonPožadavek
Section titled “Požadavek”| Políčko | Typ | Vyžadováno | Vý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á detekce | Kód zdrojového jazyka |
engine | řetězec | — | xr-397b | ID nastavení překladu, viz nastavení překladů |
output_mode | řetězec | — | bilingual | single 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_images | boolean | — | false | Také přeložte text na obrázcích v dokumentu. |
context_translation | boolean | — | false | Zapně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í .
Příklad
Section titled “Příklad”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"}| Stav | Příčina |
|---|---|
403 | Klíč nepovoluje zvolené nastavení, nebo byl odeslán neuhrazený účet glossary_id |
404 | Dokument nebo slovník neexistuje, byl smazán nebo patří jinému účtu. |
415 | Formát souboru nelze přeložit. |
422 | Soubor je prázdný, neobsahuje žádný překládaný text nebo je parametr neplatný. |
429 | Příliš mnoho požadavků nebo plná fronta; zkuste to znovu po Retry-After |
Idempotence
Section titled “Idempotence”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í.