Postman-এ OpenAI-সামঞ্জস্যপূর্ণ API-তে প্রথম রিকোয়েস্ট

আপনার কাছে একটি API key আছে এবং কোড লেখার আগে আপনি দেখতে চান আসলে কী ওয়্যারের ওপর দিয়ে যায়। Postman ঠিক এটার জন্যই ভালো: আপনি একটি URL, একটি key এবং একটি JSON body পূরণ করেন, Send চাপেন, আর উত্তর ঠিক নিচেই দেখা যায়। CheapTokens-এর জন্য রিকোয়েস্টটি হলো POST https://api.cheaptokens.dev/v1/chat/completions, একটি Authorization: Bearer key এবং একটি JSON body যা মডেলের নাম উল্লেখ করে।

নিচের ধাপগুলো Postman-এর নিজস্ব ডকস অনুসরণ করে (v12, ডকস সাইটে সর্বশেষ ভার্সন, ৩১ অক্টোবর ২০২৬-এ যাচাই করা)। আপনি যদি টার্মিনাল পছন্দ করেন, একই রিকোয়েস্ট আছে Your first API request with CheapTokens-এ।

চারটি ধাপে সেট আপ করুন#

আপনার মাত্র কয়েকটি জিনিস দরকার: base URL, আপনার key, একটি model id এবং একটি message। Postman প্রথম দুটি variable-এ রাখে, তাই key কখনো রিকোয়েস্টে পেস্ট করা হয় না।

প্রতিটি ধাপের জন্য কয়েকটি বিস্তারিত।

রিকোয়েস্ট তৈরি করুন। বাম সাইডবারে Add আইকনে ক্লিক করুন এবং HTTP বেছে নিন। method ড্রপডাউন ডিফল্টভাবে GET থাকে, তাই এটি POST-এ বদলান এবং URL লিখুন। Postman variable লেখা হয় {{variable_name}} আকারে; ডকস উদাহরণ হিসেবে {{base_url}} ব্যবহার করে। base_url-কে https://api.cheaptokens.dev/v1 হিসেবে সংজ্ঞায়িত করুন এবং URL ফিল্ড হয়ে যায় {{base_url}}/chat/completions। Postman variable স্ট্রিং হিসেবে সংরক্ষণ করে, যা এখানে ঠিক আছে।

key যোগ করুন। Authorization ট্যাব খুলুন, Auth Type ড্রপডাউনে Bearer Token বেছে নিন এবং Token ফিল্ডে {{api_key}} দিন। Postman এটি Authorization হেডার হিসেবে Bearer ফরম্যাটে পাঠায়। ডকস ঠিক এটাই সুপারিশ করে: token একটি variable-এ রাখুন এবং নাম দিয়ে রেফার করুন। এই অভ্যাস কেন গুরুত্বপূর্ণ তা আছে Store an API key safely-এ।

body লিখুন। Body ট্যাবে raw বেছে নিন, তারপর ড্রপডাউনে JSON। raw body-র জন্য Postman নিজেই সংশ্লিষ্ট Content-Type সেট করে, তাই আপনাকে সেই হেডার যোগ করতে হবে না। এটি পেস্ট করুন:

{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    { "role": "user", "content": "Explain in one sentence what a token is." }
  ],
  "max_tokens": 200
}

model id হলো CheapTokens ডকস থেকে সম্পূর্ণ gateway_id; deepseek-flash-এর মতো সংক্ষিপ্ত নাম গ্রহণ করা হয় না। max_tokens উত্তরের দৈর্ঘ্য সীমিত করে, তাই প্রথম পরীক্ষা দীর্ঘ হতে পারে না। আরেকটি Postman বিস্তারিত: JSON body-তে // এবং /* */ কমেন্ট পাঠানোর আগে সরিয়ে ফেলা হয়, তাই আপনি সহকর্মীর জন্য body-তে টীকা দিতে পারেন।

Send চাপুন এবং response পড়ুন#

সবকিছু ঠিক থাকলে, response প্যানে OpenAI Chat Completions ফরম্যাটে একটি JSON অবজেক্ট দেখায়। দুটি জায়গা গুরুত্বপূর্ণ:

• choices[0].message.content হলো উত্তর টেক্সট।
• usage ধারণ করে prompt_tokens (আপনি যা পাঠিয়েছেন) এবং completion_tokens (মডেল যা লিখেছে)। এটার জন্যই আপনাকে বিল করা হয়, তাই একেবারে প্রথম রিকোয়েস্টেই এটি দেখুন।

choices[0].finish_reason-ও দেখুন। stop মানে মডেল নিজে থেকেই শেষ করেছে; length মানে উত্তর max_tokens-এ পৌঁছে কেটে গেছে। যদি তা দেখেন, সীমা বাড়ান বা পড়ুন AI answer cut off? Fix finish_reason "length"।

উত্তর খোলার আগে এটি চেষ্টা করুন:

প্রথম রিকোয়েস্টের খরচ#

ধরুন উপরের রিকোয়েস্টে প্রায় 30 input token লাগে এবং উত্তরে প্রায় 100 output token লাগে (এটি একটি উদাহরণ, পরিমাপ নয়; আপনার usage ফিল্ড আসল সংখ্যা দেখায়)। DeepSeek-V4-Flash-এ বর্তমান মূল্যে এটি $0.00001, এবং মূল্য যেকোনো সময় একই। প্রতি 1M token-এর দাম আছে the pricing page-এর লাইভ টেবিলে।

একই Postman রিকোয়েস্ট দিয়ে অন্য মডেল চেষ্টা করা যায়। শুধু model লাইনটি বদলান, উদাহরণস্বরূপ zai-org/GLM-5.3-Flash দিয়ে (390K context, সর্বোচ্চ 8,192 output token), এবং আবার Send চাপুন। একটি ব্যালেন্স সব মডেল কভার করে, তাই আর কিছু বদলায় না: একই URL, একই key।

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

Postman response-এর পাশে status code দেখায়। এগুলো সাধারণত সন্দেহভাজন:

Postman-নির্দিষ্ট দুটি জিনিস যাচাই করা উচিত। যদি 401 পান বা URL ভুল মনে হয়, যাচাই করুন base_url এবং api_key আপনার নির্বাচিত environment-এ সংজ্ঞায়িত আছে। আর যদি key ঠিক মনে হয় কিন্তু তবুও 401 পান, Authorization ট্যাব আবার খুলুন: Auth Type অবশ্যই Bearer Token হতে হবে, No Auth নয়। এই কোডগুলো সম্পর্কে আরও: API 401 or 404 error। কোন id ব্যবহার করবেন নিশ্চিত নন? List models with GET /v1/models সবগুলো ফেরত দেয়।

যখন সন্তুষ্ট হবেন, Save চাপুন, রিকোয়েস্টের একটি নাম দিন এবং একটি collection বেছে নিন। পরের বার আপনি শুধু content ফিল্ড সম্পাদনা করবেন, অথবা উত্তর তুলনা করতে model লাইন। সম্পূর্ণ API রেফারেন্স আছে the CheapTokens docs-এ।