Vytvorte úlohu na preklad
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonŽiadosť
Section titled “Žiadosť”| Políčko | Typ | Požadované | Predvolené | Popis |
|---|---|---|---|---|
document_id | reťazec | ✅ | — | ID potvrdeného dokumentu |
target_lang | reťazec | ✅ | — | Kód cieľového jazyka |
source_lang | reťazec | — | Automatická detekcia | Kód zdrojového jazyka |
engine | reťazec | — | xr-397b | ID nastavenia prekladu, pozri nastavenia prekladu |
output_mode | reťazec | — | bilingual | single alebo bilingual |
glossary_id | reťazec | — | — | ID glosára tohto účtu. Glosáre sú určené pre platobné účty (aspoň jedna úspešná platba); nezaplatený účet, ktorý odošle jednu platbu, dostane 403 |
include_images | boolean | — | false | Tiež preložte text na obrázkoch v dokumente. |
context_translation | boolean | — | false | Povolte vylepšenie kontextu |
style_preset | reťazec | — | — | Prednastavený štýl |
Vytvorená úloha sa dostane do fronty. Každý účet spracováva naraz až 5 súborov; ďalšie úlohy sa stále vytvárajú a fronta sa automaticky postupuje, pričom sa spúšťajú tie, ktoré skončili skôr. Kým úloha čaká, jej stage_message uvádza, koľko úloh je pred ňou.
Pred spustením úlohy sa zostatok skontroluje v porovnaní s prahovou hodnotou: PDF vyžaduje zostatok nad „počet strán × 2 kreditov“; ostatné formáty sa riadia dĺžkou zdrojového textu, minimálne 2 kredity. Ak zostatok nedovoľuje spustiť súbor, táto úloha končí s status=failed a quota_exceeded=true, neúčtuje sa nič a ostatné úlohy nie sú ovplyvnené. Po dokončení úlohy sa účtuje skutočné využitie; ak náklady presiahnu zostatok, zostatok klesne do mínusu, pričom neskôr pripísané kredity najskôr splnia dlh a nové úlohy nemôžu byť spustené, kým je zostatok záporný, preto je potrebné doplniť kredit. Pozrite si kredity a využitie .
Príklad
Section titled “Prí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"}'Odpoveď 201 (serverová stage_message je v čínštine):
{ "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 | Príčina |
|---|---|
403 | Kľúč nepovoľuje zvolené nastavenie alebo nezaplatený účet odoslal glossary_id |
404 | Dokument alebo slovník neexistuje, bol zmazaný alebo patrí inému účtu. |
415 | Formát súboru nie je možné previesť. |
422 | Súbor je prázdny, neobsahuje žiadny prekladateľný text alebo je neplatný parameter. |
429 | Príliš veľa požiadaviek alebo je fronta plná; skúste to znova po Retry-After |
Idempotencia
Section titled “Idempotencia”Idempotency-Key je voliteľný, ale odporúčaný pre každú predloženú prácu. Kľúč má 1–128 viditeľných znakov ASCII a zostáva platný na neurčito pre rovnaké poverenie:
- Rovnaký kľúč, rovnaké telo: vráti sa pôvodná úloha (vrátane neúspešnej); nič sa nevytvorí ani neúčtuje dvakrát.
- Rovnaký kľúč, iné telo:
409(idempotency_request_conflict). - Pôvodná úloha bola odstránená:
410(idempotency_job_gone).
Používajte nový UUID pre každé nové odoslanie a pôvodný kľúč použite opäť iba pri opakovaní toho istého odosielania.