इसे छोड़कर कंटेंट पर जाएं

अनुवाद का कार्य बनाएँ

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