跳转到内容

Аударма жұмысын жасаңыз

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
СалалықТүріҚажетӘдепкіСипаттама
document_idжол✅—Расталған құжаттың ID-сі
target_langжол✅—Мақсатты тіл коды
source_langжол—Автоматты түрде анықтауШығарылым тілінің коды
engineжол—xr-397bАударма параметрінің ID-сі, қараңыз аударма параметрлері
output_modeжол—bilingualsingle немесе bilingual
glossary_idжол——Бұл аккаунттың глоссарий ID-сы. Глоссарийлер төлем жасаған аккаунттар үшін (кем дегенде бір сәтті төлем болуы керек); егер төленбеген аккаунт бір рет хабарлама жіберсе, оған 403 беріледі.
include_imagesboolean—falseСондай-ақ құжаттағы суреттердегі мәтінді де аударыңыз.
context_translationboolean—falseКонтексттік жетілдіруді қосыңыз
style_presetжол——Стильді алдын ала орнату

Жасалған тапсырма кезекте пайда болады. Әрбір аккаунт бір уақытта 5 файлға дейін өңдейді; одан әрі тапсырмалар жасала береді және кезек автоматты түрде, алдыңғылар аяқталған сайын іске қосылады. Тапсырма күткен кезде оның stage_message мәні алда неше тапсырманың бар екенін көрсетеді.

Жұмыс басталғанға дейін теңгерім шекті мәнмен тексеріледі: PDF үшін теңгерім «беттер × 2 кредит» мөлшерінен жоғары болуы керек; басқа форматтарда есептеу көздің мәтінінің ұзындығына байланысты, кемінде 2 кредит. Егер теңгерім файлды бастай алмаса, онда бұл жұмыс status=failed және quota_exceeded=true кодтарымен аяқталады, ешқандай төлем алынбайды және басқа жұмыстарға әсер етпейді. Жұмыс аяқталғанда нақты пайдалану сомасы есептеледі; егер шығын теңгерімнен асып кетсе, теңгерім теріс мәнге айналады, кейін келген кредиттер алдымен қарызды өтейді, ал теңгерім теріс болған кезде жаңа жұмыстар бастала алмайды, сондықтан теңгерімді толтыру қажет. кредиттер мен пайдалану туралы қараңыз.

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

Жауап 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"
}
МәртебеСебеп
403Кілт таңдалған параметрді қолдамайды немесе төленбеген шот glossary_id жіберді
404Құжат немесе глоссарий жоқ, ол жойылған немесе басқа аккаунтқа тиесілі
415Файл форматын аударуға болмайды
422Файл бос, аударылатын мәтін жоқ немесе параметр дұрыс емес
429Сұраныс тым көп немесе кезектің сыйымдылығы толды; Retry-After уақытынан кейін қайта тырысыңыз

Idempotency-Key міндетті емес, бірақ әрбір жіберілімге ұсынылады. Кілт — 1–128 көрінетін ASCII таңбалары және бірдей несие үшін шексіз уақытқа жарамды болады:

  • Бірдей кілт, бірдей корпус: бастапқы тапсырманы (сәтсіз болған жағдайда да) қайтарады; ештеңе екі рет жасалмайды немесе есептелмейді.
  • Бірдей пернелер, басқа корпус: 409 (idempotency_request_conflict).
  • Бастапқы тапсырма жойылды: 410 (idempotency_job_gone).

Әрбір жаңа жіберу үшін жаңа UUID пайдаланыңыз, ал дәл сол жіберуді қайта тырысу кезінде ғана бастапқы кілтті қайта пайдаланыңыз.