跳转到内容

Kreirajte zadatak za prevod

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
PoljeTipPotrebnoPodrazumevanoOpis
document_idniza✅—ID potvrđenog dokumenta
target_langniza✅—Kod jezika cilja
source_langniza—Automatsko otkrivanjeKod jezika izvora
engineniza—xr-397bIdentifikator postavki prevoda, pogledajte postavke prevoda
output_modeniza—bilingualsingle ili bilingual
glossary_idniza——ID glosara za ovaj nalog. Glosari se koriste za naplaćene račune (bar jedna uspešna uplata); neuplaćeni račun koji pošalje jednu uplatu dobija 403
include_imagesboolean—falseTakođe prevedite tekst na slikama u dokumentu
context_translationboolean—falseUključite poboljšanje konteksta
style_presetniza——Predustanovka stila

Kreiran zadatak ulazi u red. Svaki nalog obrađuje do 5 datoteka istovremeno; novi zadaci se i dalje kreiraju i red se automatski popunjava, počev od onih koji su prethodno završeni. Dok zadatak čeka, njegov stage_message pokazuje koliko zadataka je ispred njega.

Pre početka zadatka, stanje se proverava u odnosu na prag: za PDF je potrebno stanje veće od „stranica × 2 kredita“; ostali formati se procenjuju prema dužini izvornog teksta, najmanje 2 kredita. Ako stanje ne može da pokrene datoteku, taj zadatak se završava sa status=failed i quota_exceeded=true, ništa se ne naplaćuje, a drugi zadaci nisu pogođeni. Kada se zadatak završi, naplaćuje se stvarna potrošnja; ako trošak premaši stanje, ono postaje negativno, krediti koji stignu kasnije prvo otplaćuju dug, a novi zadaci ne mogu da se pokrenu dok je stanje negativno, pa je potrebno dopuniti račun. Pogledajte kredite i potrošnju .

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

Odgovor 201 (serverski stage_message je na kineskom):

{
"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"
}
StatusUzrok
403Ključ ne dozvoljava izabranu postavku, ili je račun koji nije plaćen poslao glossary_id
404Dokument ili pojmovnik ne postoji, bio je obrisan ili pripada drugom nalogu
415Format datoteke se ne može prevesti
422Datoteka je prazna, nema prevodiv tekst ili parametar nije važeći.
429Previše zahteva ili je red popunjen; pokušajte ponovo nakon Retry-After

Idempotency-Key je opcionalno, ali se preporučuje za svaku postavku. Ključ se sastoji od 1–128 vidljivih ASCII karaktera i ostaje važeći na neodređeno vreme za iste akreditive:

  • Isti ključ, isto telo: vraća se originalni zadatak (uključujući i neuspešni); ništa se ne kreira ili naplaćuje dva puta.
  • Isti ključ, drugo telo: 409 (idempotency_request_conflict).
  • Izvorni zadatak je izbrisan: 410 (idempotency_job_gone).

Koristite novi UUID za svaku novu postavku i ponovo koristite originalni ključ samo prilikom ponovnog pokušaja iste postavke.