अनुवाद का कार्य बनाएँ
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 | अनुवाद सेटिंग आईडी, देखें अनुवाद सेटिंग्स |
output_mode | स्ट्रिंग | — | bilingual | single या bilingual |
glossary_id | स्ट्रिंग | — | — | इस खाते की शब्दकोश आईडी। शब्दकोश केवल भुगतान किए गए खातों के लिए हैं (कम से कम एक सफल भुगतान); एक अनभिज्ञ खाता जो एक बार भुगतान करता है, उसे 403 मिलता है |
include_images | बूलियन | — | false | साथ ही, दस्तावेज़ की छवियों में मौजूद पाठ का भी अनुवाद करें। |
context_translation | बूलियन | — | false | संदर्भ सुधार चालू करें |
style_preset | स्ट्रिंग | — | — | शैली प्रीसेट |
एक बनाया गया कार्य कतार में प्रवेश करता है। प्रत्येक खाता एक समय में अधिकतम 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 उपयोग करें, और केवल उसी सबमिशन को दोबारा प्रयास करते समय ही मूल कुंजी का पुन: उपयोग करें।