গাইড
মডেল ও মূল্য
মডেল ID, প্রোভাইডার, প্রকাশিত রেট, ডিসকাউন্ট, বিলিং ইউনিট এবং একটি অনুরোধের মূল্য কীভাবে নির্ধারিত হয় তা বুঝুন।
মডেলের মূল্য USD-তে প্রকাশিত। একটি মডেল একাধিক আপস্ট্রিম প্রোভাইডারের মাধ্যমে উপলব্ধ হতে পারে এবং প্রতিটি প্রোভাইডার ভিন্ন গ্রাহক মূল্য প্রকাশ করতে পারে। এই গাইডে ব্যাখ্যা করা হয়েছে সেই মূল্যগুলো কোথা থেকে আসে এবং অনুরোধ পাঠানোর আগে কীভাবে হিসাব করবেন।
একটি মডেল ID খুঁজুন
API ফেরত দেওয়া মডেল ID ব্যবহার করুন। প্রদর্শিত নাম বা পেজ slug থেকে ID তৈরি করবেন না।
| Endpoint | ফেরত দেয় |
|---|---|
GET /api/v1/models | প্রতিটি সক্রিয় মডেল ক্যাটাগরি |
GET /api/v1/videos/models | ভিডিও জেনারেশন মডেল |
GET /api/v1/decisions/models | ডিসিশন মডেল |
GET /api/v1/models এছাড়া exclude_video_and_decisions=true এবং একটি ঐচ্ছিক provider ফিল্টার গ্রহণ করে। ডিসকভারি ক্যাটালগ পড়ে এবং মডেল কলে চার্জ করে না।
ইমেজ মডেলের কোনো নির্দিষ্ট তালিকা endpoint নেই। GET /api/v1/models-কে model_kind: "image_generation" দিয়ে ফিল্টার করুন; Image Generation দেখুন।
ব্রাউজযোগ্য দৃশ্যের জন্য মডেল ক্যাটালগ বা মূল্য পেজ খুলুন। মডেল বিস্তারিত পেজ কনটেক্সট সীমা, প্রোটোকল এবং প্রতিটি প্রকাশিত সরবরাহকারী মূল্য দেখায়।
প্রোভাইডার ও চ্যানেল
প্রতিটি মডেল পাবলিক চ্যানেলের একটি তালিকা বহন করে। একটি চ্যানেল হলো সেই মডেলের একটি আপস্ট্রিম প্রোভাইডার কনফিগারেশন, যেমন Anthropic, Azure, Google বা একটি ডিসকাউন্টেড Claude চ্যানেল।
is_defaultহেডলাইন মূল্য ও ডিফল্ট রুটে ব্যবহৃত চ্যানেল চিহ্নিত করে।runnableচিহ্নিত করে চ্যানেলটি বর্তমানে অনুরোধের জন্য উপলব্ধ কি না।standard_pricing-এ প্রোভাইডারের স্ট্যান্ডার্ড রেট থাকে।discount_multiplierহলো 0 থেকে 1 পর্যন্ত বিক্রয় মাল্টিপ্লায়ার।pricing_modeহয়configured_ratesঅথবাupstream_cost।
মডেল পেজ সরবরাহকারীদের ডিফল্টকে প্রথমে, তারপর গ্রাহক input মূল্য অনুযায়ী কম থেকে বেশি সাজায়। স্পষ্টভাবে একটি সরবরাহকারী বেছে নিতে Channels and Provider Routing দেখুন।
গ্রাহক মূল্য কীভাবে হিসাব হয়
configured_rates চ্যানেলের জন্য:
customer price = standard rate × discount multiplierউদাহরণস্বরূপ, প্রতি 1M টোকেনে $1.00 স্ট্যান্ডার্ড input রেট ও 0.8 মাল্টিপ্লায়ারযুক্ত একটি চ্যানেল প্রতি 1M টোকেনে $0.80 চার্জ করে।
upstream_cost চ্যানেলের জন্য standard_pricing হলো null, শূন্য নয়। বিলিং রিপোর্ট করা জেনারেশন খরচকে হিমায়িত (frozen) ডিসকাউন্ট দিয়ে গুণ করার ভিত্তিতে হয়। মডেল পেজ সেই চ্যানেলের প্রকৃত নিয়ম দেখায়।
পাঠযোগ্যতার জন্য টোকেন রেট প্রতি 1 মিলিয়ন টোকেনে দেখানো হয়। বিলিং বর্তমান মূল্য স্ন্যাপশটের প্রতি-টোকেন নির্ভুলতা ব্যবহার করে।
বিলিং একক
| একক | সাধারণ ব্যবহার | কীভাবে মাপা হয় |
|---|---|---|
| টোকেন | Chat, রিজনিং, embeddings, টেক্সট জেনারেশন | input ও output টোকেন আলাদাভাবে; cache read ও write-এর নিজস্ব রেট থাকতে পারে |
| ইমেজ টোকেন | ইমেজ জেনারেশন ও এডিটিং | input ও output ইমেজ টোকেন আলাদাভাবে; প্রতি ইমেজে output টোকেন সংখ্যা রেজোলিউশনের উপর নির্ভর করে |
| অনুরোধ | কিছু ইমেজ ও ইউটিলিটি endpoint | প্রতি কলে নির্দিষ্ট চার্জ |
| সেকেন্ড বা টিয়ার | ভিডিও জেনারেশন | সময়কাল, রেজোলিউশন, reference input বা অন্য প্রকাশিত শর্ত |
একাধিক মূল্য শর্ত মিললে মডেলের pricing details-এ তালিকাভুক্ত প্রথম মিলে যাওয়া শর্ত প্রযোজ্য। বড় জবের আনুমানিক খরচ বের করার আগে টিয়ারের জন্য মডেল বিস্তারিত পেজ দেখুন।
Cache রেট
একটি মডেল input_cache_read বা input_cache_write প্রকাশ করলে সেই রেট ক্যাটালগে ও মডেল পেজে দেখায়। cache ব্যবহার প্রোটোকল রেসপন্সে রিপোর্ট হয়; cache hit নিশ্চিত নয় এবং এটি আপস্ট্রিম প্রোভাইডার ও অনুরোধের উপর নির্ভর করে। Felo আলাদা কোনো cache সুইচ যোগ করে না।
মূল্য কোথায় দেখবেন
- মূল্য পেজ — মডেল ও সরবরাহকারী তুলনা করুন।
- মডেল বিস্তারিত পেজ — সম্পূর্ণ রেট টেবিল, টিয়ার ও শর্ত।
- Model catalog API — JSON-এ একই ডেটা, 60 সেকেন্ডের মধ্যে রিফ্রেশ হয়।
আপনার অ্যাপ্লিকেশনে মূল্য হার্ডকোড করবেন না। ক্যাটালগ পড়ুন বা মূল্য পেজের লিংক দেখান যাতে মূল্য পরিবর্তন আপনার খরচের আনুমানিক হিসাব নীরবে ভাঙতে না পারে।
একটি অনুরোধের আনুমানিক খরচ বের করুন
- মডেল ID ও আপনি যে চ্যানেল ব্যবহার করার পরিকল্পনা করছেন তা খুঁজুন।
- সেই চ্যানেলের input, output ও cache রেট পড়ুন।
- আপনার প্রত্যাশিত টোকেন সংখ্যা দিয়ে গুণ করুন, অথবা নন-টোকেন মডেলের জন্য অনুরোধ বা সময়কালের রেট ব্যবহার করুন।
- প্রযোজ্য যেকোনো শর্তসাপেক্ষ টিয়ার যোগ করুন।
- রিট্রাই ও output ভ্যারিয়েন্সের জন্য কিছু মার্জিন রাখুন।