跳转到内容

ক্রেডিট এবং ব্যবহার

চার্জযোগ্য পরিষেবাগুলি অ্যাকাউন্ট ক্রেডিটের মাধ্যমে নিষ্পত্তি করা হয়। পরিমাণগুলি মিলিক্রেডিটে ( millicredits ) দেওয়া হয়; 1000 মিলিক্রেডিট সমান 1 ক্রেডিট। আপনি অনুরোধে প্রেরণ করা পরিমাণগুলি পূর্ণসংখ্যা হতে হবে; ব্যালেন্স এবং রেকর্ডে থাকা পরিমাণগুলিতে একটি দশমিক স্থান (0.1 মিলিক্রেডিট) থাকতে পারে। প্রতিক্রিয়ায় credit_precision হল 4, যার অর্থ ক্রেডিটে রূপান্তরিত হওয়ার পরে সর্বাধিক 4টি দশমিক স্থান থাকতে পারে।

ব্যালেন্স পরীক্ষা করুন

Section titled “ব্যালেন্স পরীক্ষা করুন”
GET /api/v1/billing/credits/balance
Terminal window
curl https://omnidoc.top/api/v1/billing/credits/balance \
-H "X-API-Key: $OMNIDOC_API_KEY"

মূল ক্ষেত্রগুলো:

ক্ষেত্রঅর্থ
availableঋণ পরিশোধের পর এখন উপলব্ধ মিলিক্রেডিট; ঋণের ক্ষেত্রে ঋণাত্মক।
debtমিলিক্রেডিটে ঋণ: সম্পন্ন কাজগুলোর প্রকৃত খরচের যে অংশ ব্যালেন্সের চেয়ে বেশি, তা। পরবর্তীতে আসা ক্রেডিট (টপ-আপ, দৈনিক অনুদান, রিডিম কোড, রিফান্ড ইত্যাদি) প্রথমে এই ঋণ পরিশোধ করে।
spentমোট মিলিক্রেডিট নিষ্পত্তি করা হয়েছে
expiredমেয়াদ উত্তীর্ণ বা প্রত্যাহৃত মিলিক্রেডিটস্
today_chargedআজ মিলিক্রেডিট নিষ্পত্তি হয়েছে
lotsক্রেডিট লটগুলির বর্তমান বৈধতা এবং তাদের মেয়াদ শেষের তারিখ
GET /api/v1/billing/credits/plans

একটি পাবলিক এন্ডপয়েন্ট যা সাইন-ইনের প্রয়োজন পড়ে না এবং বিক্রয়ের জন্য উপলব্ধ প্যাকগুলো (purchase_plans) ফেরত দেয়, যেখানে প্ল্যান কোড দ্বারা চিহ্নিত করা হয়। এখন বিক্রয়ের জন্য উপলব্ধ:

প্ল্যান কোডক্রেডিটসমূল্যবোনাস
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (সুপারিশকৃত)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • “Bonus” ¥29.90-এর জন্য 10,000 ক্রেডিটের মূল্যের বিপরীতে গণনা করা হয় এবং এটি bonus_percent ফিল্ড; সুপারিশকৃত প্যাকে recommended: true রয়েছে। যখন এটি নির্ধারিত থাকে না, তখন কোনো ফিল্ডই দেখা যায় না।
  • price_fen (ফেন এককে, 1/100 ইউয়ান) মূল্যের জন্য এবং total_millicredits (মিলিক্রেডিট) ক্রেডিটের জন্য প্রাধিকারপ্রাপ্ত। কেনা ক্রেডিটের মেয়াদ শেষ হয় না; প্যাকগুলি আবারও কেনা যায় এবং প্রতিবার একসঙ্গে সরবরাহ করা হয়।

চার্জিং লাইফসাইকেল

Section titled “চার্জিং লাইফসাইকেল”
  1. একটি কাজ শুরু হওয়ার আগে ব্যালেন্স একটি থ্রেশহোল্ডের সাথে তুলনা করে যাচাই করা হয় : ব্যালেন্স (ঋণ বাদে) কাজের থ্রেশহোল্ডের উপরে থাকতে হবে, যেমন PDF অনুবাদের জন্য “পৃষ্ঠা × 2 ক্রেডিট”, অন্যান্য ফাইলের ক্ষেত্রে উৎস পাঠ্যের দৈর্ঘ্য (কমপক্ষে 2 ক্রেডিট), এবং অডিও, ভিডিও ও স্পিচের জন্য সার্ভার পরিমাপ করা সময়কাল বা অক্ষর থেকে গণনা করা খরচ (মূল্য অডিও, ভিডিও এবং ভয়েস -এ)। একটি বাজেটযুক্ত API কী ব্যবহার করলে, কীটির অবশিষ্ট বাজেটও থ্রেশহোল্ডের উপরে থাকতে হবে। অন্যথায় প্রতিক্রিয়া হয় 402 (একটি ফাইল অনুবাদ কাজ ব্যর্থ হয়ে শেষ হয় quota_exceeded=true, একটি মিডিয়া কাজ শেষ হয় error_code=insufficient_credits) এবং কোনো চার্জ ধার্য করা হয় না। একটি কাজ শুরু করলে ব্যালেন্স পরিবর্তিত হয় না।
  2. প্রকৃত ব্যবহারের জন্য চার্জ প্রযোজ্য হয় যখন এটি সম্পন্ন হয় : ফাইল অনুবাদ (ছবিসহ), ব্যাচভিত্তিক সমৃদ্ধ টেক্সট, ডকুমেন্ট অপারেশন, অডিও, ভিডিও এবং স্পিচের জন্য প্রকৃত ব্যবহারের পূর্ণ পরিমাণ চার্জ প্রযোজ্য হয় সম্পন্ন হওয়ার পর। একটি API কী-এর বাজেট শুধুমাত্র শুরুর আগে চেকে অংশ নেয় এবং কোনো সম্পন্ন কাজের চার্জ কখনোই কমায় না; যদি তাতে কী-এর ব্যবহৃত বাজেট তার সীমা অতিক্রম করে, তবে সীমা বাড়ানো না হওয়া পর্যন্ত কী নতুন কাজ শুরু করতে পারবে না। ব্যর্থ বা বাতিল করা কাজের জন্য কোনো চার্জ প্রযোজ্য নয়।
  3. ব্যালেন্স ঋণাত্মক হতে পারে : প্রকৃত খরচের যে অংশ ব্যালেন্সের চেয়ে বেশি, তা ঋণ হিসেবে নথিভুক্ত করা হয় এবং ব্যালেন্স ঋণাত্মক হিসেবে প্রদর্শিত হয়; পরে আসা ক্রেডিটগুলো প্রথমে ঋণ পরিশোধ করে। ব্যালেন্স ঋণাত্মক থাকা অবস্থায় নতুন কাজ শুরু করা যায় না; ব্যালেন্স পূরণ করুন।

ক্লায়েন্টরা কখনোই “কত চার্জ করা উচিত” এমন প্রশ্ন জিজ্ঞাসা করে না; সার্ভার ডেলিভারি হওয়া পণ্যের ভিত্তিতে নির্ধারিত পরিমাণ গণনা করে।

অপারেশন এবং রেকর্ডসমূহ

Section titled “অপারেশন এবং রেকর্ডসমূহ”
GET /api/v1/billing/credits/operations?limit=20
GET /api/v1/billing/credits/operations/{operation_id}
GET /api/v1/billing/credits/jobs/{job_id}

একটি রেকর্ডে অপারেশন আইডি, স্ট্যাটাস, বিলিং বেসিস এবং চার্জ করা ও ফেরত দেওয়া পরিমাণ থাকে। একটি API কী দিয়ে তালিকাভুক্ত হলে, অপারেশনগুলো শুধুমাত্র সেই কী দ্বারা শুরু করা হয়েছে এমন অপারেশনগুলোই অন্তর্ভুক্ত করে।

GET /api/v1/usage?limit=50
GET /api/v1/usage/summary

ব্যবহারের এন্ডপয়েন্টগুলো অ্যাকাউন্টের ফাইল সংখ্যা, অক্ষর, টোকেন এবং প্রক্রিয়াকরণ সময় ফেরত দেয়।

অনুসন্ধানগুলি বিনামূল্যে

Section titled “অনুসন্ধানগুলি বিনামূল্যে”

ব্যালেন্স, জব স্ট্যাটাস, ব্যবহার, সেটেলমেন্ট রেকর্ড, ফলাফলের তালিকা এবং ডাউনলোডের ঠিকানা পরীক্ষা করতে কোনো ক্রেডিট খরচ হয় না।