OpenAI-সামঞ্জস্যপূর্ণ API: base_url কী এবং কীভাবে পরিবর্তন করবেন

একটি OpenAI-সামঞ্জস্যপূর্ণ API হলো এমন একটি API যা OpenAI-এর Chat Completions API-এর মতো একই ফরম্যাটে অনুরোধ গ্রহণ করে এবং একই ফরম্যাটে উত্তর দেয়। একটি অ্যাপকে অন্য প্রোভাইডারে সরাতে, সাধারণত আপনাকে তিনটি মান পরিবর্তন করতে হয়: base_url (অনুরোধ কোথায় যাবে), API কী, এবং মডেল আইডি। আপনার বাকি কোড, মেসেজ লিস্ট এবং উত্তর পড়ার পদ্ধতি সহ, অপরিবর্তিত থাকে।

এই গাইডটি ধারণাটি সহজ ভাষায় ব্যাখ্যা করে এবং Python ও curl-এ CheapTokens-এ একটি কার্যকর প্রথম অনুরোধ দিয়ে শেষ হয়। CheapTokens সম্পর্কিত তথ্য ২২ অক্টোবর, ২০২৬-এ এর ডকুমেন্টেশনের সাথে যাচাই করা হয়েছে।

"OpenAI-সামঞ্জস্যপূর্ণ" মানে কী?#

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

বাস্তবে এর অর্থ হলো যেকোনো সামঞ্জস্যপূর্ণ প্রোভাইডারে তিনটি জিনিস একই থাকে:

• অনুরোধ: একটি JSON বডি যাতে একটি model ফিল্ড এবং একটি messages তালিকা থাকে, যেখানে প্রতিটি মেসেজে একটি role (system, user বা assistant) এবং content থাকে।
• এন্ডপয়েন্ট পাথ: /chat/completions, বেস URL-এর পরে যোগ করা হয়।
• প্রতিক্রিয়া: একটি JSON অবজেক্ট যেখানে উৎপন্ন টেক্সট choices[0].message.content-এ থাকে।

যেহেতু ফরম্যাটটি শেয়ার করা, অফিসিয়াল SDK এবং অনেক অ্যাপ যেকোনো সামঞ্জস্যপূর্ণ প্রোভাইডারের সাথে কথা বলতে পারে। তাদের শুধু জানতে হয় অনুরোধ কোথায় পাঠাতে হবে।

base_url কী?#

base_url হলো সেই ঠিকানা যা দিয়ে প্রতিটি অনুরোধ শুরু হয়। একটি SDK এতে কলের পাথ যোগ করে সম্পূর্ণ ঠিকানা তৈরি করে।

তাই যখন আপনি একটি ভিন্ন base_url সেট করেন, একই কোড একই ধরনের অনুরোধ একটি ভিন্ন সার্ভারে পাঠায়। CheapTokens বেস URL হলো https://api.cheaptokens.dev/v1। এর API OpenAI Chat Completions এবং Anthropic Messages-এর সাথে সামঞ্জস্যপূর্ণ, এবং একটি প্রিপেইড ব্যালেন্স সব মডেল কভার করে।

যে তিনটি মান আপনি পরিবর্তন করেন#

মডেল আইডি মনোযোগ দাবি করে। বিভিন্ন প্রোভাইডার একই মডেলকে ভিন্ন আইডি দেয়, তাই অন্য পরিষেবার আইডি এখানে কাজ করবে না। CheapTokens ডকুমেন্টেশন থেকে আইডি নিন। এখন উপলব্ধ আইডিগুলো:

DeepSeek-V4-Flash প্রতি উত্তরে 32,768 টোকেন পর্যন্ত ফেরত দেয় এবং এর 380K কনটেক্সট আছে; GLM-5.3-Flash-এর 390K কনটেক্সট আছে; MiniMax-M2.7-এর 180K কনটেক্সট আছে। তিনটিই একই ব্যালেন্স থেকে বিল হয়, তাই তাদের মধ্যে পরিবর্তন মানে শুধু মডেল আইডি পরিবর্তন করা।

Python-এ প্রথম অনুরোধ#

openai প্যাকেজ ইনস্টল করুন, তারপর কোডে লেখার পরিবর্তে আপনার কী একটি এনভায়রনমেন্ট ভেরিয়েবলে সংরক্ষণ করুন:

pip install openai
export CHEAPTOKENS_API_KEY="YOUR_CHEAPTOKENS_KEY"

এখন কোড। একটি সাধারণ OpenAI উদাহরণ থেকে একমাত্র পার্থক্য হলো base_url আর্গুমেন্ট, কী এবং মডেল আইডি:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",   # 1. where requests go
    api_key=os.environ["CHEAPTOKENS_API_KEY"],   # 2. your CheapTokens key
)

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",                # 3. model id from the docs
    messages=[
        {"role": "system", "content": "You answer briefly."},
        {"role": "user", "content": "Explain base_url in one sentence."},
    ],
)

print(response.choices[0].message.content)

উদাহরণের কীটি একটি প্লেসহোল্ডার: YOUR_CHEAPTOKENS_KEY আপনার নিজের কী দিয়ে প্রতিস্থাপন করুন এবং কখনো একটি রিয়েল কী রিপোজিটরিতে কমিট করবেন না।

যদি আপনার ইতিমধ্যে থাকা একটি অ্যাপ কনফিগ ফাইল বা এনভায়রনমেন্ট ভেরিয়েবল থেকে সেটিংস পড়ে, তাহলে আপনাকে এর কোড সম্পাদনা করতে হবে না। base URL, API base বা endpoint নামের ফিল্ডগুলো খুঁজুন এবং সেখানে একই তিনটি মান পূরণ করুন।

curl দিয়ে একই অনুরোধ#

curl দেখায় SDK পর্দার আড়ালে কী করে: বেস URL প্লাস পাথ, Authorization হেডারে কী, এবং একটি JSON বডি।

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "messages": [
      {"role": "user", "content": "Explain base_url in one sentence."}
    ]
  }'

আপনার যা দেখা উচিত#

সবকিছু সঠিকভাবে সেট করা থাকলে, Python স্ক্রিপ্ট একটি সংক্ষিপ্ত টেক্সট উত্তর প্রিন্ট করে, এবং curl একটি JSON অবজেক্ট প্রিন্ট করে। choices তালিকাটি খুঁজুন: উত্তরের টেক্সট choices[0].message.content-এ থাকে। যদি আপনি এটি দেখেন, CheapTokens-এ আপনার প্রথম অনুরোধ কাজ করেছে, এবং আপনি আপনার আসল অ্যাপে এগিয়ে যেতে পারেন।

এর খরচ কত?#

বিলিং টোকেন দ্বারা হয়, ইনপুট এবং আউটপুটের জন্য আলাদাভাবে গণনা করা হয় (দেখুন ইনপুট বনাম আউটপুট টোকেন)। উদাহরণস্বরূপ, MiniMax-M2.7 বর্তমানে প্রতি 1M ইনপুট টোকেনে $0.05 এবং প্রতি 1M আউটপুট টোকেনে $0.15 খরচ করে। নিচের টেবিলটি সর্বদা সমস্ত মডেলের বর্তমান মূল্য দেখায়, কোনো পিক-আওয়ার সারচার্জ ছাড়াই।

সম্পূর্ণ মডেল তালিকার মূল্যও CheapTokens মূল্য পৃষ্ঠা-এ আছে।

যদি এটি কাজ না করে#

• প্রমাণীকরণ ত্রুটি (সাধারণত 401): কী অনুপস্থিত, ভুল টাইপ করা বা অতিরিক্ত স্পেস আছে। যাচাই করুন যে এনভায়রনমেন্ট ভেরিয়েবলটি সেই একই টার্মিনালে সেট করা আছে যেখানে আপনি স্ক্রিপ্ট চালান।
• "Not found" (সাধারণত 404): base_url পরীক্ষা করুন। এটি /v1 দিয়ে শেষ হতে হবে, এবং আপনি যখন SDK ব্যবহার করেন তখন আপনার নিজে /chat/completions যোগ করা উচিত নয়, নাহলে পাথ দ্বিগুণ হবে।
• অজানা মডেল: উপরের টেবিল বা ডকুমেন্টেশন থেকে মডেল আইডি সঠিকভাবে কপি করুন, বড় হাতের অক্ষর এবং স্ল্যাশের আগের অংশ সহ।
• সংযোগ নেই বা টাইমআউট: দেখুন সাধারণ সংযোগ ত্রুটি এবং কীভাবে সেগুলো ঠিক করবেন।
• উত্তর বাক্যের মাঝখানে কাটা: max_tokens সীমায় পৌঁছেছে, যা কেন একটি AI উত্তর বাক্যের মাঝখানে থামে-এ আলোচনা করা হয়েছে।

পরবর্তী পদক্ষেপ#

প্রথম অনুরোধ কাজ করার পরে, আপনি Python-এ স্ট্রিমিং যোগ করতে পারেন, আপনার এডিটর বা এজেন্টে একই তিনটি মান প্লাগ করতে পারেন, অথবা AI মডেলের নাম কীভাবে পড়বেন পড়তে পারেন। সেটআপের বিবরণ এবং মডেলের সম্পূর্ণ তালিকা CheapTokens ডকুমেন্টেশন-এ আছে।