跳转到内容

Stvorite zadatak za prijevod

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
PoljeVrstaPotrebnoPodrazinaOpis
document_idniz✅—ID potvrđenog dokumenta
target_langniz✅—Kôd ciljanskog jezika
source_langniz—Automatsko otkrivanjeKôd izvornog jezika
engineniz—xr-397bID za postavke prijevoda, pogledajte postavke prijevoda
output_modeniz—bilingualsingle ili bilingual
glossary_idniz——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_imageslogički tip—falseTakođer prevedite tekst na slikama u dokumentu.
context_translationlogički tip—falseUključite poboljšanje konteksta
style_presetniz——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 .

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 (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"
}
StatusUzrok
403Ključ ne dopušta odabranu postavku ili je nesplaćeni račun poslao glossary_id
404Dokument ili glosar ne postoji, izbrisan je ili pripada drugom računu
415Format datoteke nije moguće prevesti
422Datoteka je prazna, nema prevodivog teksta ili je parametar nevažeći.
429Previše zahtjeva ili red čekanja je pun; pokušajte ponovo nakon Retry-After

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.