Аударма жұмысын жасаңыз
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonСұраныс
Section titled “Сұраныс”| Салалық | Түрі | Қажет | Әдепкі | Сипаттама |
|---|---|---|---|---|
document_id | жол | ✅ | — | Расталған құжаттың ID-сі |
target_lang | жол | ✅ | — | Мақсатты тіл коды |
source_lang | жол | — | Автоматты түрде анықтау | Шығарылым тілінің коды |
engine | жол | — | xr-397b | Аударма параметрінің ID-сі, қараңыз аударма параметрлері |
output_mode | жол | — | bilingual | single немесе bilingual |
glossary_id | жол | — | — | Бұл аккаунттың глоссарий ID-сы. Глоссарийлер төлем жасаған аккаунттар үшін (кем дегенде бір сәтті төлем болуы керек); егер төленбеген аккаунт бір рет хабарлама жіберсе, оған 403 беріледі. |
include_images | boolean | — | false | Сондай-ақ құжаттағы суреттердегі мәтінді де аударыңыз. |
context_translation | boolean | — | false | Контексттік жетілдіруді қосыңыз |
style_preset | жол | — | — | Стильді алдын ала орнату |
Жасалған тапсырма кезекте пайда болады. Әрбір аккаунт бір уақытта 5 файлға дейін өңдейді; одан әрі тапсырмалар жасала береді және кезек автоматты түрде, алдыңғылар аяқталған сайын іске қосылады. Тапсырма күткен кезде оның stage_message мәні алда неше тапсырманың бар екенін көрсетеді.
Жұмыс басталғанға дейін теңгерім шекті мәнмен тексеріледі: PDF үшін теңгерім «беттер × 2 кредит» мөлшерінен жоғары болуы керек; басқа форматтарда есептеу көздің мәтінінің ұзындығына байланысты, кемінде 2 кредит. Егер теңгерім файлды бастай алмаса, онда бұл жұмыс status=failed және quota_exceeded=true кодтарымен аяқталады, ешқандай төлем алынбайды және басқа жұмыстарға әсер етпейді. Жұмыс аяқталғанда нақты пайдалану сомасы есептеледі; егер шығын теңгерімнен асып кетсе, теңгерім теріс мәнге айналады, кейін келген кредиттер алдымен қарызды өтейді, ал теңгерім теріс болған кезде жаңа жұмыстар бастала алмайды, сондықтан теңгерімді толтыру қажет. кредиттер мен пайдалану туралы қараңыз.
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"}'Жауап 201 (сервердің stage_message тілі қытайша):
{ "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"}Қателер
Section titled “Қателер”| Мәртебе | Себеп |
|---|---|
403 | Кілт таңдалған параметрді қолдамайды немесе төленбеген шот glossary_id жіберді |
404 | Құжат немесе глоссарий жоқ, ол жойылған немесе басқа аккаунтқа тиесілі |
415 | Файл форматын аударуға болмайды |
422 | Файл бос, аударылатын мәтін жоқ немесе параметр дұрыс емес |
429 | Сұраныс тым көп немесе кезектің сыйымдылығы толды; Retry-After уақытынан кейін қайта тырысыңыз |
Идемпотенттілік
Section titled “Идемпотенттілік”Idempotency-Key міндетті емес, бірақ әрбір жіберілімге ұсынылады. Кілт — 1–128 көрінетін ASCII таңбалары және бірдей несие үшін шексіз уақытқа жарамды болады:
- Бірдей кілт, бірдей корпус: бастапқы тапсырманы (сәтсіз болған жағдайда да) қайтарады; ештеңе екі рет жасалмайды немесе есептелмейді.
- Бірдей пернелер, басқа корпус:
409(idempotency_request_conflict). - Бастапқы тапсырма жойылды:
410(idempotency_job_gone).
Әрбір жаңа жіберу үшін жаңа UUID пайдаланыңыз, ал дәл сол жіберуді қайта тырысу кезінде ғана бастапқы кілтті қайта пайдаланыңыз.