Stvorite zadatak za prijevod
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonZahtjev
Section titled “Zahtjev”| Polje | Vrsta | Potrebno | Podrazina | Opis |
|---|---|---|---|---|
document_id | niz | ✅ | — | ID potvrđenog dokumenta |
target_lang | niz | ✅ | — | Kôd ciljanskog jezika |
source_lang | niz | — | Automatsko otkrivanje | Kôd izvornog jezika |
engine | niz | — | xr-397b | ID za postavke prijevoda, pogledajte postavke prijevoda |
output_mode | niz | — | bilingual | single ili bilingual |
glossary_id | niz | — | — | ID glosara za ovaj račun. Glosari su namijenjeni naplaćenim računima (najmanje jedna uspješna uplata); neplaćeni račun koji pošalje jednu uplatu dobiva 403 |
include_images | logički tip | — | false | Također prevedite tekst na slikama u dokumentu. |
context_translation | logički tip | — | false | Uključite poboljšanje konteksta |
style_preset | niz | — | — | Preset za stil |
Stvoreni zadatak ulazi u red čekanja. Svaki račun obrađuje najviše 5 datoteka istovremeno; dodatni zadaci se i dalje kreiraju i red čekanja automatski, počevši kako raniji završavaju. Dok zadatak čeka, njegov stage_message pokazuje koliko je zadataka ispred.
Prije početka zadatka, stanje se provjerava prema pragovima: za PDF potrebno je stanje veće od “stranica × 2 kredita”; ostali formati ovisi o duljini izvornog teksta, minimalno 2 kredita. Ako stanje ne može pokrenuti datoteku, taj zadatak završava s status=failed i quota_exceeded=true, ništa se ne naplaćuje, a drugi zadaci nisu pogođeni. Kada zadatak završi, naplaćuje se stvarna potrošnja; ako trošak premaši stanje, stanje postaje negativno, krediti koji stignu kasnije prvo podmiruju dug, a novi zadaci ne mogu započeti dok je stanje negativno, stoga dopunite račun. Pogledajte kredite i potrošnju .
Primjer
Section titled “Primjer”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 (serverov 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 dopušta odabranu postavku ili je nesplaćeni račun poslao glossary_id |
404 | Dokument ili glosar ne postoji, izbrisan je ili pripada drugom računu |
415 | Format datoteke nije moguće prevesti |
422 | Datoteka je prazna, nema prevodivog teksta ili je parametar nevažeći. |
429 | Previše zahtjeva ili red čekanja je pun; pokušajte ponovo nakon Retry-After |
Idempotentnost
Section titled “Idempotentnost”Idempotency-Key je opcionalan, ali preporučljiv za svaku dostavu. Ključ sadrži 1–128 vidljivih znakova ASCII i ostaje valjan na neograničeno vrijeme za iste akreditive:
- Ista ključna riječ, isto tijelo: vraća se izvorni zadatak (uključujući i neuspješni); ništa se ne stvara niti naplaćuje dva puta.
- Isti ključ, drugo tijelo:
409(idempotency_request_conflict). - Izvorni zadatak je izbrisan:
410(idempotency_job_gone).
Za svaku novu predaju koristite novi UUID, a izvorni ključ ponovno koristite samo prilikom ponovnog pokušaja iste predaje.