Hozzon létre egy fordítási feladatot
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonKérés
Szekció neve “Kérés”| Tér | Típus | Kötelező | Alapértelmezett | Leírás |
|---|---|---|---|---|
document_id | string | ✅ | — | Megerősített dokumentum azonosítója |
target_lang | string | ✅ | — | Célnyelv kódja |
source_lang | string | — | Automatikus észlelés | Forrásnyelvi kód |
engine | string | — | xr-397b | Fordítási beállítás azonosítója, lásd fordítási beállítások |
output_mode | string | — | bilingual | single vagy bilingual |
glossary_id | string | — | — | Ennek a fióknak a glosszárium-azonosítója. A glosszáriumok csak fizető fiókokhoz tartoznak (legalább egy sikeres fizetéssel); egy nem kifizetett fiók, amely küld egyet, 403 kap |
include_images | logikai érték | — | false | Fordítsa le a dokumentum képein található szöveget is |
context_translation | logikai érték | — | false | Kapcsolja be a kontextusfejlesztést |
style_preset | string | — | — | Stílus-előrebeállítás |
A létrehozott feladat bekerül a sorba. Minden fiók egyszerre legfeljebb 5 fájlt dolgoz fel; további feladatok is létrejönnek, és a sor automatikusan halad, az előzőek befejezésével együtt. Amíg egy feladat várakozik, a stage_message jelzi, hány feladat van még előtte.
Mielőtt egy munka elindul, az egyenleget ellenőrzik egy küszöbértékkel szemben: egy PDF esetén az egyenlegnek a „lapok × 2 kredit” felett kell lennie; más formátumoknál a forrás szöveg hossza alapján dől el, minimum 2 kredit. Ha az egyenleg nem elegendő egy fájl indításához, az adott munka status=failed és quota_exceeded=true jelzéssel zárul, semmi sem kerül felszámolásra, és a többi munka nem érintett. Amikor egy munka befejeződik, a tényleges felhasználást felszámolják; ha a költség meghaladja az egyenleget, az egyenleg mínuszba kerül, a később érkező kreditek először a tartozást fizetik ki, és amíg az egyenleg negatív, új munkák nem indulhatnak, ezért feltöltés szükséges. Lásd krediteket és felhasználást .
Példa
Szekció neve “Példa”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"}'Válasz 201 (a kiszolgáló stage_message nyelve kínai):
{ "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"}Hibák
Szekció neve “Hibák”| Állapot | Ok |
|---|---|
403 | A kulcs nem engedélyezi a kiválasztott beállítást, vagy egy fizetetlen fiók küldött glossary_id |
404 | A dokumentum vagy szótár nem létezik, törölve lett vagy egy másik fiókhoz tartozik. |
415 | A fájlformátum nem fordítható |
422 | A fájl üres, nincs benne fordítható szöveg, vagy egy paraméter érvénytelen. |
429 | Túl sok kérés, vagy a sor tele van; próbálja újra Retry-After után |
Idempotencia
Szekció neve “Idempotencia”A Idempotency-Key opcionális, de minden beküldésnél ajánlott. A kulcs 1–128 látható ASCII karakterből áll, és ugyanazon hitelesítő adatok esetén határozatlan ideig érvényes marad:
- Ugyanaz a kulcs, ugyanaz a test: visszatéríti az eredeti munkát (beleértve a sikerteleneket is); semmi nem kerül létrehozásra vagy díjbeszedésre kétszer.
- Ugyanaz a kulcs, más test:
409(idempotency_request_conflict). - Az eredeti feladat törölve lett:
410(idempotency_job_gone).
Használjon új UUID -et minden új beküldéshez, és csak ugyanannak a beküldésnek az újrapróbálása esetén használja újra az eredeti kulcsot.