মূল্য নির্ধারণ

প্রতিটি মডেলের জন্য ঠিক সেই মূল্যই নেওয়া হয়, যা মডেলটির নির্মাতা এর জন্য নেন, US ডলারে। আপনি আপনার API ব্যালান্স থেকে পেমেন্ট করেন, যা API ক্রেডিট-এ গণনা করা হয়: ১,০০০ API ক্রেডিট = ১$। API ব্যালান্সটি আলাদা একটি ব্যালান্স; Doitong অ্যাপগুলোর ক্রেডিটের সঙ্গে এর কোনো সম্পর্ক নেই। কোনো প্ল্যান, ন্যূনতম পরিমাণ বা প্রতি-মডেল ফি নেই: একটি কলের মূল্যই নেওয়া হয়, এবং রিকোয়েস্ট গ্রহণ করা হলে তা API ব্যালান্স থেকে কেটে নেওয়া হয়।

রাশিয়ায় (doitong.ru, api.doitong.ru, অথবা ?currency=rub) মূল্য রুবলেও দেখানো হয়: USD মূল্য × USD/RUB হার × ১.৩।

ইউনিট#

প্রতিটি মডেলের একটি বিলিং ইউনিট থাকে, যা তার পেজে এবং GET https://api.doitong.ru/v1/models/{model_id}-এ দেখানো হয়:

মূল্য = পরিমাণ × প্রতি ইউনিটে API ক্রেডিট, পূর্ণ API ক্রেডিটে (০.০০১$) ঊর্ধ্বমুখী রাউন্ড করা হয়, তবে কখনোই 1-এর কম নয়। খুব সস্তা ইউনিটের প্রতি ইউনিটে ভগ্নাংশ মূল্য থাকতে পারে (0.4 API ক্রেডিট প্রতি সেকেন্ড); শুধু পুরো কলের মোট মূল্য রাউন্ড করা হয়।

কিছু মডেল ইনপুটের ওপর নির্ভর করে ভিন্ন হার নেয়: শব্দসহ ভিডিওর মূল্য শব্দহীন ভিডিওর চেয়ে বেশি, 4K-এর মূল্য 1K-এর চেয়ে বেশি, ইত্যাদি। এই নিয়মগুলো প্রতিটি মডেল পেজে তালিকাভুক্ত থাকে। আপনি কোনো প্যারামিটার বাদ দিলে সেটি তার ডিফল্ট মান হিসেবে গণ্য হয়, তাই কোনো ইনপুটের জন্য যে মূল্য দেখেন, সেটিই আপনাকে দিতে হবে।

সঠিক, পরিমাপিত, আনুমানিক এবং ব্যবহারভিত্তিক মূল্য#

প্রতিটি মূল্যের একটি mode থাকে:

• exact: আপনার ইনপুট থেকে মূল্য গণনা করা হয় (সেকেন্ড, ছবি, মেগাপিক্সেল, অক্ষর, ধাপ, অথবা প্রতি ভিডিও বা কলের জন্য একটি নির্দিষ্ট মূল্য)।
• measured: আপনার পাঠানো ফাইল অনুযায়ী মূল্য নির্ধারিত হয়: ইনপুট ভিডিও বা অডিওর দৈর্ঘ্য, ইনপুট ছবির আকার, ভিডিওর ফ্রেম রেট বা ফ্রেমের সংখ্যা। আপস্কেলার, লিপ সিঙ্ক, ভিডিও-টু-ভিডিও, ট্রান্সক্রিপশন এবং অডিও টুলের মূল্য এভাবেই নির্ধারিত হয়। রান শুরুর আগে API ফাইলের দৈর্ঘ্য, রেজোলিউশন এবং ফ্রেম রেট পড়ে (কোটও একই কাজ করে), তাই কোটে দেখানো মূল্যই রানে নেওয়া হয়। মডেল পেজে কীসের জন্য মূল্য দিতে হবে তা বলা থাকে ("আপনার ইনপুট ভিডিওর প্রতি সেকেন্ডের মূল্য") এবং এর ক্যালকুলেটর আপনার ফাইলের সংখ্যাগুলো ব্যবহার করে। যে ফাইল পড়া যায় না, তা unmeasurable_input দিয়ে প্রত্যাখ্যান করা হয় এবং কোনো মূল্য নেওয়া হয় না।
• estimate: মডেলের নিজস্ব খরচ এমন কিছুর ওপর নির্ভর করে যা ইনপুট থেকে আগে জানা যায় না (টোকেন, কম্পিউট টাইম)। এমন মডেল প্রতি রানে একটি নির্দিষ্ট আনুমানিক মূল্য নেয় (ছবির সংখ্যা থাকলে প্রতি আউটপুট ছবির জন্য), যা ওই মডেলের বাস্তব রানগুলোর গড় খরচ থেকে নির্ধারিত। রান করার আগেই আপনি মূল্য জানতে পারবেন: কোটে যা দেখায়, আপনাকে সেটিই দিতে হবে।
• metered: মডেলকে প্রকৃত ব্যবহারের ভিত্তিতে মূল্য নেওয়া হয়, যা শুধু রান নিজেই জানে: ভাষা বা ভিশন মডেল যে টোকেন পড়ে ও লেখে, ভয়েস মডেল যে সেকেন্ডের স্পিচ তৈরি করে, অথবা মডেলের প্রসেসিং টাইম। নিচে ব্যবহারভিত্তিক মূল্য দেখুন।

মডেল পেজে "প্রতি রানে মূল্য", "আপনার ইনপুট ভিডিওর প্রতি সেকেন্ডের মূল্য" (এবং অনুরূপ), "প্রতি রানে আনুমানিক মূল্য" অথবা "ব্যবহারভিত্তিক মূল্য" লেখা থাকে; GET https://api.doitong.ru/v1/models?mode=measured, ?mode=estimate এবং ?mode=metered এগুলো তালিকাভুক্ত করে।

ব্যবহারভিত্তিক মূল্য#

একটি metered মডেলের একটি ব্যবহারমূল্য থাকে ("প্রতি 1000 টোকেনে $0.01", "তৈরি করা অডিওর প্রতি সেকেন্ডে $0.002", "প্রতি সেকেন্ড প্রসেসিং টাইমে $0.00111") এবং একটি প্রতি রানে সর্বোচ্চ মূল্য থাকে: আপনার রিকোয়েস্টে যা বলা আছে (max_tokens, আপনার টেক্সটের দৈর্ঘ্য, রেজোলিউশন, আউটপুটের সংখ্যা) এবং মডেলের প্রকাশিত সীমা অনুযায়ী রানটির সর্বোচ্চ খরচ। এটি কখনোই URL-এর পেছনে থাকা কোনো ফাইলের কনটেন্টের ওপর নির্ভর করে না। প্রসেসিং টাইম বা ভয়েস সেশনের দৈর্ঘ্য অনুযায়ী বিল করা মডেলের ক্ষেত্রে সর্বোচ্চ মূল্য হলো একটি রিকোয়েস্ট যতক্ষণ চলতে পারে তার মূল্য (ছবির জন্য 15 মিনিট, অডিওর জন্য 30, ভিডিওর জন্য 60), তাই এটি সাধারণ রানের চেয়ে অনেক বেশি। যে ইনপুটের সর্বোচ্চ মূল্য মডেলের প্রতি-রান সীমার চেয়ে বেশি (অত্যন্ত দীর্ঘ টেক্সট), সেটি 422 invalid_input দিয়ে প্রত্যাখ্যান করা হয়:

1. কোট credits হিসেবে সেই সর্বোচ্চ মূল্য ফেরত দেয় (hold এবং typical-সহ, যা সাধারণ রানের মূল্য)। রান শুরু হলে, সর্বোচ্চ মূল্য API ব্যালান্স থেকে কেটে নেওয়া হয়, এবং ব্যালান্স ও আপনার কী বাজেট—উভয়কেই তা বহন করতে হয়।
2. রান সফল হলে, মডেল যে ব্যবহার জানায় সেই অনুযায়ী রিকোয়েস্টের হিসাব চূড়ান্ত করা হয়: ব্যবহার × ব্যবহারমূল্য, পূর্ণ API ক্রেডিটে ঊর্ধ্বমুখী রাউন্ড করে। সর্বোচ্চ মূল্যের অব্যবহৃত অংশ স্বয়ংক্রিয়ভাবে অর্থ ফেরত দেওয়া হয়, একবার, আপনার API ব্যালান্সের refund সারি হিসেবে।
3. কোনো রান তার সর্বোচ্চ মূল্যের চেয়ে বেশি খরচ করে না, ব্যবহার তেমন হলেও। ব্যর্থ বা বাতিল রান সবসময়ের মতো সম্পূর্ণ অর্থ ফেরত পায়।

বেশিরভাগ রানের মূল্য সর্বোচ্চ মূল্যের চেয়ে অনেক কম; মডেল পেজে বিল্ডারের ইনপুটের জন্য "প্রতি রানে সর্বোচ্চ $X" এবং সাধারণ রান (ক্যাটালগে "from") দেখানো হয়। প্রসেসিং টাইম অনুযায়ী বিল করা অল্প কয়েকটি মডেলের ক্ষেত্রে ব্যবহার হলো মডেলের প্রসেসিং টাইম (চিহ্নিত approximate)।

{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}

রানের পরে, রিকোয়েস্টের cost-এ কত ধরা হয়েছিল এবং ব্যবহারের পরিমাণ কত হয়েছে তা দেখা যায়:

{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}

charged − refunded হলো রানের খরচ। ফলাফল এবং হিসাব চূড়ান্ত করার মধ্যবর্তী সময়ে settled.status হলো pending, এবং বিরল ক্ষেত্রে মডেল কোনো ব্যবহার না জানালে এটি no_usage হয় (তখন সর্বোচ্চ মূল্যই মূল্য হিসেবে থাকে)।

রান করার আগে কোট#

POST https://api.doitong.ru/v1/quote/{model_id} ঠিক সেই বডি নেয় যা আপনি run-এ পাঠাবেন এবং সেই ইনপুটের মূল্য ফেরত দেয়: সঠিক মূল্য, ব্যবহারভিত্তিক মূল্যযুক্ত মডেল-এর ক্ষেত্রে রানটির সর্বোচ্চ সম্ভাব্য মূল্য। এর জন্য কোনো কী লাগে না এবং কোনো খরচও হয় না:

curl -X POST "https://api.doitong.ru/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'

{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}

কী থাকলে কোট balance_credits এবং balance_usd (আপনার API ব্যালান্স), affordable এবং key_budget_remaining-ও ফেরত দেয়। একটি rub পরিমাণের জন্য ?currency=rub যোগ করুন।

মূল্য অবজেক্ট#

API-র প্রতিটি মূল্যের একই কাঠামো থাকে:

• models: price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second", "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" } — রাশিয়ায় অথবা ?currency=rub-সহ rub, rub_display এবং from_rub-ও থাকে;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API ক্রেডিট; ব্যবহারভিত্তিক রিকোয়েস্টে mode, held, typical এবং settled যোগ হয়, ব্যবহারভিত্তিক মূল্য দেখুন);
• account: GET https://api.doitong.ru/v1/account credits (API ব্যালান্স), balance: { "credits", "usd" } এবং storage (ফাইল স্টোরেজের মূল্য, ব্যবহার ও মাসিক আনুমানিক মূল্য) ফেরত দেয়।

অর্থ ফেরত#

• একটি অবৈধ রিকোয়েস্ট (রান শুরুর আগে যেকোনো 4xx) থেকে কখনো মূল্য নেওয়া হয় না।
• failed অবস্থায় শেষ হওয়া রিকোয়েস্ট ( timeout সহ) স্বয়ংক্রিয়ভাবে API ব্যালান্সে সম্পূর্ণ অর্থ ফেরত পায়।
• রান শুরুর আগে আপনি বাতিল করা রিকোয়েস্ট সম্পূর্ণ অর্থ ফেরত পায়। মডেল তৈরি করা শুরু করার পর বাতিল করা শুধু একটি রিকোয়েস্ট: মডেল শেষ করলে ফলাফল পাঠানো হয় এবং মূল্য নেওয়া হয়।
• সফল metered রিকোয়েস্ট তার সর্বোচ্চ মূল্যের অব্যবহৃত অংশ ফেরত পায়।

রিকোয়েস্ট অবজেক্টে সবকিছু দেখা যায়: cost.credits, cost.charged এবং cost.refunded।

ফাইল স্টোরেজ#

আউটপুট ফাইল আমাদের স্টোরেজে রাখা হয়। আপনি অ্যাকাউন্টে বা প্রতি রানে (?storage=) বেছে নিতে পারেন:

পার্মানেন্ট স্টোরেজের মূল্য API ব্যালান্স থেকে দিনে একবার নেওয়া হয়: রাখা GB × মাসিক মূল্য ÷ মাসের দিনের সংখ্যা, storage ধরনের লেজার সারি হিসেবে। API ক্রেডিটের ভগ্নাংশ পরের দিনে বহন করা হয়, তাই এক মাসে মোট ঠিক GB × ১০০ API ক্রেডিট হয় (1 GB = 1024³ bytes; এক মাস 10 GB রাখার মূল্য ১,০০০ API ক্রেডিট)। ব্যালান্স কখনো শূন্যের নিচে যায় না: মূল্য পরিশোধ করা না গেলে সেদিন কোনো চার্জ নেওয়া হয় না, আপনাকে ইমেল করা হয়, এবং রাখা ফাইলগুলো temporary হয়ে ৭ দিন পরে মুছে ফেলার আগে টপ-আপ করার জন্য আপনার কাছে ৩০ দিন থাকে। বিস্তারিত: Files।

বর্তমান মূল্য#

এগুলো নির্বাচিত মডেল। সব ১,৪৯৬টি মডেল ও এর মূল্য মডেল ক্যাটালগে এবং GET /models-এ (কী প্রয়োজন নেই) আছে।

টপ-আপ#

https://doitong.ru/developers/dashboard#balance-এ API ব্যালান্সে টাকা যোগ করুন। ব্যালান্স খুব কম হলে, একটি রান 402 insufficient_credits এবং top_up_url দিয়ে উত্তর দেয়। প্রতিটি API কী-র জন্য API ক্রেডিটে আলাদা বাজেট নির্ধারণ করেও সীমা বসানো যায় (Authentication দেখুন)।