পদ্মা

কুইকস্টার্ট

বিদ্যমান OpenAI SDK ইন্টিগ্রেশনে তিনটি পরিবর্তন: base URL, কী এবং মডেলের নাম।

Base URL

https://padmarouter.com/v1

১ · ইনস্টল

bash
pip install openai

২ · একটি রিকোয়েস্ট পাঠান

python
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["PADMA_API_KEY"],
    base_url="https://padmarouter.com/v1",
)

res = client.chat.completions.create(
    model="anthropic/claude-sonnet-4",
    messages=[{"role": "user", "content": "Hello from Dhaka!"}],
)
print(res.choices[0].message.content)

৩ · অথবা রাউটারকে বেছে নিতে দিন

একটি নির্দিষ্ট মডেলের পরিবর্তে auto/* id পাঠান এবং গেটওয়ে যে মডেলগুলোতে পৌঁছাতে পারে সেগুলোকে গুণমান, দাম এবং লেটেন্সিতে স্কোর করে, তারপর সেরা ফিটে ফরওয়ার্ড করে। আপনাকে যে মডেল উত্তর দিয়েছে তার হারে বিল করা হয়, এবং রেসপন্স জানায় সেটি কোনটি ছিল।

python
res = client.chat.completions.create(
    model="auto/smart",          # or auto/cheap, auto/fast, auto/bangla
    messages=[{"role": "user", "content": "Hello from Dhaka!"}],
)
# The model that answered comes back on the response headers:
#   x-padma-router: auto/smart
#   x-padma-model:  anthropic/claude-sonnet-4

৪ · ব্যবহারের হেডারগুলো পড়ুন

প্রতিটি রেসপন্সে মিটার করা খরচ থাকে তাই আপনি আপনার নিজের রিকোয়েস্ট ID-এর পাশে খরচ লগ করতে পারেন। স্ট্রিমড রেসপন্সে শুধু রিকোয়েস্ট id এবং মডেল থাকে — তাদের হেডার টোকেন গণনার আগে পাঠানো হয়, তাই চার্জ সার্ভার-সাইডে রেকর্ড করা হয় এবং Activity-তে দেখা যায়।

headers
x-padma-request-id:  req_9fb2a41c8e
x-padma-model:       anthropic/claude-sonnet-4
x-padma-tokens-in:   1284
x-padma-tokens-out:  421
x-padma-cost-bdt:    1.22
x-padma-balance-bdt: 1841.38

ত্রুটি ও পুনরায় চেষ্টা

স্ট্যাটাসকোডঅর্থ
401invalid_api_keyকী অনুপস্থিত, ত্রুটিপূর্ণ বা অজানা। কখনো বিল হয় না।
402insufficient_balanceওয়ালেটে রিকোয়েস্ট কভার করার মতো ব্যালেন্স নেই। চালিয়ে যেতে টপ আপ করুন।
404model_not_foundএই মডেল id নেই। ডিরেক্টরির জন্য GET /v1/models দেখুন।
429key_daily_limitআপনার সেট করা সীমায় পৌঁছেছে। প্রদানকারীকে কল করার আগেই প্রত্যাখ্যান।
502upstream_unreachableপ্রদানকারীতে পৌঁছানো যায়নি। কখনো বিল হয় না।
503model_unavailableকোনো আপস্ট্রিম কনফিগার করা নেই বা রুট অবনমিত। কখনো বিল হয় না।

এখানে দেখানো ডকুমেন্টেশন একটি সংক্ষিপ্ত প্রোটোটাইপ। সম্পূর্ণ রেফারেন্স, SDK গাইড এবং ত্রুটি টেবিল API-এর সাথে পাঠানো হবে।