Tovább a tartalomhoz

Hozzon létre egy fordítási feladatot

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
TérTípusKötelezőAlapértelmezettLeírás
document_idstring✅—Megerősített dokumentum azonosítója
target_langstring✅—Célnyelv kódja
source_langstring—Automatikus észlelésForrásnyelvi kód
enginestring—xr-397bFordítási beállítás azonosítója, lásd fordítási beállítások
output_modestring—bilingualsingle vagy bilingual
glossary_idstring——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_imageslogikai érték—falseFordítsa le a dokumentum képein található szöveget is
context_translationlogikai érték—falseKapcsolja be a kontextusfejlesztést
style_presetstring——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 .

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"}'

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"
}
ÁllapotOk
403A kulcs nem engedélyezi a kiválasztott beállítást, vagy egy fizetetlen fiók küldött glossary_id
404A dokumentum vagy szótár nem létezik, törölve lett vagy egy másik fiókhoz tartozik.
415A fájlformátum nem fordítható
422A fájl üres, nincs benne fordítható szöveg, vagy egy paraméter érvénytelen.
429Túl sok kérés, vagy a sor tele van; próbálja újra Retry-After után

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.