Creați o sarcină de traducere
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonCerere
Section titled “Cerere”| Câmp | Tip | Necesar | Implicit | Descriere |
|---|---|---|---|---|
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-397b | ID de setare a traducerii, vezi setări de traducere |
output_mode | șir de caractere | — | bilingual | single 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_images | boolean | — | false | De asemenea, traduceți textul din imaginile documentului |
context_translation | boolean | — | false | Activează î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 .
Exemplu
Section titled “Exemplu”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"}| Stare | Motiv |
|---|---|
403 | Cheia nu permite setarea selectată, sau un cont neplătit a trimis glossary_id |
404 | Documentul sau glossarul nu există, a fost șters sau aparține unui alt cont |
415 | Formatul de fișier nu poate fi tradus |
422 | Fișierul este gol, nu conține text traductibil sau un parametru este invalid |
429 | Prea multe cereri, sau coada este plină; resetați după Retry-After |
Idempotență
Section titled “Idempotență”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.