Kreirajte zadatak za prevod
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonZahtev
Section titled “Zahtev”| Polje | Tip | Potrebno | Podrazumevano | Opis |
|---|---|---|---|---|
document_id | niza | ✅ | — | ID potvrđenog dokumenta |
target_lang | niza | ✅ | — | Kod jezika cilja |
source_lang | niza | — | Automatsko otkrivanje | Kod jezika izvora |
engine | niza | — | xr-397b | Identifikator postavki prevoda, pogledajte postavke prevoda |
output_mode | niza | — | bilingual | single ili bilingual |
glossary_id | niza | — | — | 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_images | boolean | — | false | Takođe prevedite tekst na slikama u dokumentu |
context_translation | boolean | — | false | Uključite poboljšanje konteksta |
style_preset | niza | — | — | 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 .
Primer
Section titled “Primer”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"}Greške
Section titled “Greške”| Status | Uzrok |
|---|---|
403 | Ključ ne dozvoljava izabranu postavku, ili je račun koji nije plaćen poslao glossary_id |
404 | Dokument ili pojmovnik ne postoji, bio je obrisan ili pripada drugom nalogu |
415 | Format datoteke se ne može prevesti |
422 | Datoteka je prazna, nema prevodiv tekst ili parametar nije važeći. |
429 | Previše zahteva ili je red popunjen; pokušajte ponovo nakon Retry-After |
Idempotentnost
Section titled “Idempotentnost”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.