Sari la conținut

Creați o sarcină de traducere

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
CâmpTipNecesarImplicitDescriere
document_idșir de caractere✅—ID al unui document confirmat
target_langșir de caractere✅—Codul limbii țintă
source_langșir de caractere—Detectare automatăCodul limbii de origine
engineșir de caractere—xr-397bID de setare a traducerii, vezi setări de traducere
output_modeșir de caractere—bilingualsingle sau bilingual
glossary_idșir de caractere——Un ID de glossar pentru acest cont. Glossarele sunt valabile pentru conturi plătite (cu cel puțin o plată reușită); un cont neplătit care trimite una primește 403
include_imagesboolean—falseDe asemenea, traduceți textul din imaginile documentului
context_translationboolean—falseActivează îmbunătățirea contextului
style_presetșir de caractere——Setare predefinită de stil

Un job creat intră în coadă. Fiecare cont procesează până la 5 fișiere simultan; alte job-uri continuă să fie create și adăugate automat la coadă, începând pe măsură ce cele mai vechi se finalizează. În timp ce un job așteaptă, indicatorul său stage_message indică numărul de joburi care îl preced.

Înainte de începerea unei lucrări, soldul este verificat față de un prag: un PDF necesită un sold superior la „pagini × 2 credite”; celelalte formate se bazează pe lungimea textului sursă, minim 2 credite. Dacă soldul nu permite începerea unui fișier, acea lucrare se încheie cu status=failed și quota_exceeded=true, nu se facturează nimic, iar alte lucrări nu sunt afectate. La finalizarea unei lucrări, se facturează consumul efectiv; dacă costul depășește soldul, acesta devine negativ, creditele primite ulterior acoperă mai întâi datoria, iar noi lucrări nu pot fi începute atât timp cât soldul este negativ, deci trebuie reîncărcat. Vezi credite și consum .

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

Răspuns 201 (serverul stage_message este în limba chineză):

{
"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"
}
StareMotiv
403Cheia nu permite setarea selectată, sau un cont neplătit a trimis glossary_id
404Documentul sau glossarul nu există, a fost șters sau aparține unui alt cont
415Formatul de fișier nu poate fi tradus
422Fișierul este gol, nu conține text traductibil sau un parametru este invalid
429Prea multe cereri, sau coada este plină; resetați după Retry-After

Idempotency-Key este opțional, dar recomandat pentru fiecare submitere. O cheie este formată din 1–128 de caractere ASCII vizibile și rămâne valabilă la nesfârșit pentru aceeași credențial:

  • Aceeași cheie, același corp: returnează sarcina originală (inclusiv una eșuată); nimic nu este creat sau facturat de două ori.
  • Aceeași cheie, corp diferit: 409 (idempotency_request_conflict).
  • Treaba originală a fost ștearsă: 410 (idempotency_job_gone).

Utilizați un UUID nou pentru fiecare submitere nouă și reutilizați cheia originală doar atunci când relansați aceeași submitere.