একটি অনুবাদ কাজ তৈরি করুন
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonঅনুরোধ
Section titled “অনুরোধ”| ক্ষেত্র | ধরন | প্রয়োজনীয় | ডিফল্ট | বর্ণনা |
|---|---|---|---|---|
document_id | স্ট্রিং | ✅ | — | নিশ্চিত নথির আইডি |
target_lang | স্ট্রিং | ✅ | — | লক্ষ্য ভাষার কোড |
source_lang | স্ট্রিং | — | স্বয়ংক্রিয়ভাবে সনাক্ত করুন | সূত্রগুলিকে মূল আকারেই রাখুন: কখনোই ল্যাটেক্স মার্কআপ ভেঙে বা পুনর্লিখন করবেন না; প্রতিটি সমীকরণ মূল আকারেই রাখুন। শৈলীর প্রয়োজনীয়তা: সংক্ষিপ্ত প্রযুক্তিগত লেখা ব্যবহার করুন। পণ্যের নাম, কোড আইডেন্টিফায়ার, ফাইল পাথ, একক এবং সংক্ষিপ্ত শব্দ অপরিবর্তিত রাখুন, যদি না কোনো স্থানীয়কৃত প্রমিত শব্দ থাকে। |
engine | স্ট্রিং | — | xr-397b | অনুবাদ সেটিংস আইডি, দেখুন অনুবাদ সেটিংস |
output_mode | স্ট্রিং | — | bilingual | single বা bilingual |
glossary_id | স্ট্রিং | — | — | এই অ্যাকাউন্টের একটি গ্লোসারি আইডি। গ্লোসারি শুধুমাত্র পেমেন্টযোগ্য অ্যাকাউন্টের জন্য (অন্তত একটি সফল পেমেন্ট); যদি কোনো অপেমেন্টযোগ্য অ্যাকাউন্ট থেকে একটি পেমেন্ট পাঠানো হয়, তবে এটি 403 পাবে। |
include_images | বুলিয়ান | — | false | এছাড়াও নথিতে থাকা ছবির পাঠ্যগুলোও অনুবাদ করুন। |
context_translation | বুলিয়ান | — | false | প্রসঙ্গ উন্নতি চালু করুন |
style_preset | স্ট্রিং | — | — | স্টাইল প্রিসেট |
একটি তৈরি করা জব কিউতে প্রবেশ করে। প্রতিটি অ্যাকাউন্ট একসময়ে ৫টি পর্যন্ত ফাইল প্রক্রিয়া করে; আরও জব তৈরি হতে থাকে এবং কিউ স্বয়ংক্রিয়ভাবে শুরু হয়, আগের জবগুলো শেষ হওয়ার সাথে সাথে। একটি জব অপেক্ষা করার সময়, এর 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 ঐচ্ছিক, তবে প্রতিটি জমা দেওয়ার জন্য এটি সুপারিশ করা হয়। একটি কী হল ১–১২৮টি দৃশ্যমান ASCII অক্ষর এবং একই শংসাপত্রের জন্য এটি অনির্দিষ্টকালের জন্য বৈধ থাকে:
- একই কী, একই বডি: আসল জব (ব্যর্থ হওয়া জব সহ) ফেরত দেয়; কিছুই দ্বিতীয়বার তৈরি বা চার্জ করা হয় না।
- একই কী, ভিন্ন বডি:
409(idempotency_request_conflict)। - আসল কাজটি মুছে ফেলা হয়েছিল:
410(idempotency_job_gone)।
প্রতিটি নতুন জমা দেওয়ার জন্য একটি নতুন UUID ব্যবহার করুন, এবং একই জমা দেওয়ার চেষ্টা পুনরাবৃত্তি করার সময় মাত্র আসল কীটি পুনরায় ব্যবহার করুন।