কুইকস্টার্ট
বিদ্যমান OpenAI SDK ইন্টিগ্রেশনে তিনটি পরিবর্তন: base URL, কী এবং মডেলের নাম।
Base URL
https://padmarouter.com/v1
১ · ইনস্টল
pip install openai২ · একটি রিকোয়েস্ট পাঠান
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 পাঠান এবং গেটওয়ে যে মডেলগুলোতে পৌঁছাতে পারে সেগুলোকে গুণমান, দাম এবং লেটেন্সিতে স্কোর করে, তারপর সেরা ফিটে ফরওয়ার্ড করে। আপনাকে যে মডেল উত্তর দিয়েছে তার হারে বিল করা হয়, এবং রেসপন্স জানায় সেটি কোনটি ছিল।
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-তে দেখা যায়।
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ত্রুটি ও পুনরায় চেষ্টা
| স্ট্যাটাস | কোড | অর্থ |
|---|---|---|
| 401 | invalid_api_key | কী অনুপস্থিত, ত্রুটিপূর্ণ বা অজানা। কখনো বিল হয় না। |
| 402 | insufficient_balance | ওয়ালেটে রিকোয়েস্ট কভার করার মতো ব্যালেন্স নেই। চালিয়ে যেতে টপ আপ করুন। |
| 404 | model_not_found | এই মডেল id নেই। ডিরেক্টরির জন্য GET /v1/models দেখুন। |
| 429 | key_daily_limit | আপনার সেট করা সীমায় পৌঁছেছে। প্রদানকারীকে কল করার আগেই প্রত্যাখ্যান। |
| 502 | upstream_unreachable | প্রদানকারীতে পৌঁছানো যায়নি। কখনো বিল হয় না। |
| 503 | model_unavailable | কোনো আপস্ট্রিম কনফিগার করা নেই বা রুট অবনমিত। কখনো বিল হয় না। |
এখানে দেখানো ডকুমেন্টেশন একটি সংক্ষিপ্ত প্রোটোটাইপ। সম্পূর্ণ রেফারেন্স, SDK গাইড এবং ত্রুটি টেবিল API-এর সাথে পাঠানো হবে।