Preskočiť na obsah

Vytvorte úlohu na preklad

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
PolíčkoTypPožadovanéPredvolenéPopis
document_idreťazec✅—ID potvrdeného dokumentu
target_langreťazec✅—Kód cieľového jazyka
source_langreťazec—Automatická detekciaKód zdrojového jazyka
enginereťazec—xr-397bID nastavenia prekladu, pozri nastavenia prekladu
output_modereťazec—bilingualsingle alebo bilingual
glossary_idreťazec——ID glosára tohto účtu. Glosáre sú určené pre platobné účty (aspoň jedna úspešná platba); nezaplatený účet, ktorý odošle jednu platbu, dostane 403
include_imagesboolean—falseTiež preložte text na obrázkoch v dokumente.
context_translationboolean—falsePovolte vylepšenie kontextu
style_presetreťazec——Prednastavený štýl

Vytvorená úloha sa dostane do fronty. Každý účet spracováva naraz až 5 súborov; ďalšie úlohy sa stále vytvárajú a fronta sa automaticky postupuje, pričom sa spúšťajú tie, ktoré skončili skôr. Kým úloha čaká, jej stage_message uvádza, koľko úloh je pred ňou.

Pred spustením úlohy sa zostatok skontroluje v porovnaní s prahovou hodnotou: PDF vyžaduje zostatok nad „počet strán × 2 kreditov“; ostatné formáty sa riadia dĺžkou zdrojového textu, minimálne 2 kredity. Ak zostatok nedovoľuje spustiť súbor, táto úloha končí s status=failed a quota_exceeded=true, neúčtuje sa nič a ostatné úlohy nie sú ovplyvnené. Po dokončení úlohy sa účtuje skutočné využitie; ak náklady presiahnu zostatok, zostatok klesne do mínusu, pričom neskôr pripísané kredity najskôr splnia dlh a nové úlohy nemôžu byť spustené, kým je zostatok záporný, preto je potrebné doplniť kredit. Pozrite si kredity a využitie .

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

Odpoveď 201 (serverová stage_message je v čínštine):

{
"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"
}
StavPríčina
403Kľúč nepovoľuje zvolené nastavenie alebo nezaplatený účet odoslal glossary_id
404Dokument alebo slovník neexistuje, bol zmazaný alebo patrí inému účtu.
415Formát súboru nie je možné previesť.
422Súbor je prázdny, neobsahuje žiadny prekladateľný text alebo je neplatný parameter.
429Príliš veľa požiadaviek alebo je fronta plná; skúste to znova po Retry-After

Idempotency-Key je voliteľný, ale odporúčaný pre každú predloženú prácu. Kľúč má 1–128 viditeľných znakov ASCII a zostáva platný na neurčito pre rovnaké poverenie:

  • Rovnaký kľúč, rovnaké telo: vráti sa pôvodná úloha (vrátane neúspešnej); nič sa nevytvorí ani neúčtuje dvakrát.
  • Rovnaký kľúč, iné telo: 409 (idempotency_request_conflict).
  • Pôvodná úloha bola odstránená: 410 (idempotency_job_gone).

Používajte nový UUID pre každé nové odoslanie a pôvodný kľúč použite opäť iba pri opakovaní toho istého odosielania.