跳转到内容

अनुवाद कार्य तयार करा

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
क्षेत्रप्रकारआवश्यकडीफॉल्टवर्णन
document_idstring✅—पुष्टीकृत दस्तऐवजाचा आयडी
target_langstring✅—लक्ष्य भाषा कोड
source_langstring—स्वयंचलित शोधस्रोत भाषा कोड
enginestring—xr-397bअनुवाद सेटिंग आयडी, पहा अनुवाद सेटिंग्ज
output_modestring—bilingualsingle किंवा bilingual
glossary_idstring——या खात्याची शब्दकोश आयडी. शब्दकोश हे पेमेंट केलेल्या खात्यांसाठी असतात (किमान एक यशस्वी पेमेंट असणे आवश्यक); जे अनपेमेंटेड खाते एकदा पाठवते त्याला 403 मिळते
include_imagesबूलियन—falseतसेच दस्तऐवजातील प्रतिमांमधील मजकूरही अनुवादित करा.
context_translationबूलियन—falseसंदर्भ सुधारणा चालू करा
style_presetstring——शैली प्रीसेट

निर्माण केलेले जॉब क्यूमध्ये प्रवेश करतो. प्रत्येक अकाउंट एका वेळी जास्तीत जास्त 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 वापरा, आणि त्याच सबमिशनचा पुन्हा प्रयत्न करतानाच फक्त मूळ की पुन्हा वापरा.