अनुवाद कार्य तयार करा
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonविनंती
Section titled “विनंती”| क्षेत्र | प्रकार | आवश्यक | डीफॉल्ट | वर्णन |
|---|---|---|---|---|
document_id | string | ✅ | — | पुष्टीकृत दस्तऐवजाचा आयडी |
target_lang | string | ✅ | — | लक्ष्य भाषा कोड |
source_lang | string | — | स्वयंचलित शोध | स्रोत भाषा कोड |
engine | string | — | xr-397b | अनुवाद सेटिंग आयडी, पहा अनुवाद सेटिंग्ज |
output_mode | string | — | bilingual | single किंवा bilingual |
glossary_id | string | — | — | या खात्याची शब्दकोश आयडी. शब्दकोश हे पेमेंट केलेल्या खात्यांसाठी असतात (किमान एक यशस्वी पेमेंट असणे आवश्यक); जे अनपेमेंटेड खाते एकदा पाठवते त्याला 403 मिळते |
include_images | बूलियन | — | false | तसेच दस्तऐवजातील प्रतिमांमधील मजकूरही अनुवादित करा. |
context_translation | बूलियन | — | false | संदर्भ सुधारणा चालू करा |
style_preset | string | — | — | शैली प्रीसेट |
निर्माण केलेले जॉब क्यूमध्ये प्रवेश करतो. प्रत्येक अकाउंट एका वेळी जास्तीत जास्त 5 फाइल्स हाताळते; आणखी जॉब्स निर्माण होत राहतात आणि क्यू स्वयंचलितपणे सुरू राहतो, जसजशा आधीच्या जॉब्स संपतात. एखादा जॉब प्रतीक्षा करत असताना, त्याचा stage_message दर्शवतो की पुढे किती जॉब्स आहेत.
काम सुरू होण्यापूर्वी, शिल्लक एका थ्रेशोल्डच्या तुलनेत तपासली जाते: PDF ला “पाने × 2 क्रेडिट्स” पेक्षा जास्त शिल्लक आवश्यक असते; इतर स्वरूपांसाठी मूळ मजकूराच्या लांबीचा नियम लागू होतो, जी कमीत कमी 2 क्रेडिट्स असते. जर शिल्लक एखादी फाइल सुरू करू शकत नसेल, तर ते काम status=failed आणि quota_exceeded=true सह संपते, कोणतेही शुल्क आकारले जात नाही आणि इतर कामांवर कोणताही परिणाम होत नाही. एखादे काम संपल्यावर, प्रत्यक्ष वापराचे शुल्क आकारले जाते; जर खर्च शिल्लक ओलांडला तर शिल्लक ऋणात जाते, नंतर येणारे क्रेडिट्स प्रथम थकबाकी भरतात आणि शिल्लक ऋणात असताना नवीन कामे सुरू होऊ शकत नाहीत, म्हणून शिल्लक भरा. क्रेडिट्स आणि वापर पहा .
उदाहरण
Section titled “उदाहरण”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 वापरा, आणि त्याच सबमिशनचा पुन्हा प्रयत्न करतानाच फक्त मूळ की पुन्हा वापरा.