OpenHands-কে CheapTokens-এ সংযুক্ত করুন: মডেল, Base URL, কী

Advanced চালু করার পর Settings > LLM-এ তিনটি ফিল্ড পূরণ করে আপনি CheapTokens মডেলে OpenHands চালাতে পারেন: Custom Model (openai/deepseek-ai/DeepSeek-V4-Flash-0731), Base URL (https://api.cheaptokens.dev/v1), এবং API Key। এটাই পুরো সেটআপ। এই পৃষ্ঠার বাকি অংশে প্রতিটি ফিল্ডের অর্থ এবং সেগুলোর কোনোটি ভুল হলে কেমন দেখায় তা বর্ণনা করা হয়েছে।

ফিল্ডের নাম এবং মডেল-স্ট্রিং নিয়ম OpenHands ডকসের OpenAI-সামঞ্জস্যপূর্ণ এন্ডপয়েন্ট পৃষ্ঠা থেকে নেওয়া (৮ নভেম্বর ২০২৬-এ যাচাইকৃত; পৃষ্ঠাটিতে কোনো তারিখ বা সংস্করণ নেই)। সেই তারিখে OpenHands-এর সর্বশেষ রিলিজ v1.37.0 (৬ নভেম্বর ২০২৬)। আপনার বিল্ডে কোনো লেবেল সামান্য ভিন্ন দেখালে অবস্থান অনুযায়ী যান: মডেল, বেস URL, কী।

Settings খোলার আগে#

হাতের কাছে তিনটি জিনিস থাকলে একটি রাউন্ড ট্রিপ বাঁচবে: কী, মডেল আইডি এবং Settings-এ প্রবেশাধিকার।

কী এবং বেস URL-এ নতুন? What base_url is and how to switch কয়েক মিনিটে তা কভার করে, এবং list models with GET /v1/models দেখায় কীভাবে নিজে একটি আইডি খুঁজে বের করবেন।

তিনটি ফিল্ড#

Settings > LLM খুলুন এবং Advanced চালু করুন। Base URL ফিল্ডটি Advanced টগলের নিচে অবস্থিত।

ডকস মডেল নিয়মটি এভাবে বর্ণনা করে: Custom Model হলো openai/ এর পরে মডেলের নাম, এবং যদি আপনি এমন প্রক্সি ব্যবহার করেন যার নিজস্ব প্রিফিক্স আছে, openai/<proxy-prefix>/<model-name>। openai/-এর পরের অংশটি মডেলের নাম। CheapTokens-এর জন্য আইডি হলো deepseek-ai/DeepSeek-V4-Flash-0731, তাই সম্পূর্ণ স্ট্রিং হলো openai/deepseek-ai/DeepSeek-V4-Flash-0731।

এজেন্টের জন্য কেন এই মডেল? DeepSeek-V4-Flash-এর 380K কনটেক্সট উইন্ডো এবং প্রতি উত্তরে সর্বোচ্চ 32,768 আউটপুট টোকেন, এবং যেকোনো সময়ে একই দাম, তাই দীর্ঘ সেশন পিক টাইমে বেশি ব্যয়বহুল হয় না। একটি কোডিং এজেন্ট প্রতিটি ধাপে প্রচুর কনটেক্সট পুনরায় পাঠায়, এবং উইন্ডোটি সেটার জন্যই।

GLM পছন্দ? একই ফিল্ডে openai/zai-org/GLM-5.3-Flash (390K কনটেক্সট, সর্বোচ্চ 8,192 আউটপুট টোকেন) ব্যবহার করুন এবং আর কিছু পরিবর্তন করবেন না। একই ব্যালেন্স, একই কী, একই Base URL।

প্রথমে OpenHands-এর বাইরে অংশগুলো যাচাই করুন#

এজেন্টকে দোষ দেওয়ার আগে, একই URL, কী এবং আইডি দিয়ে একটি অনুরোধ পাঠান। এটি কাজ করলে, বাকি কোনো সমস্যা থাকলে তা আপনার ফিল্ড টাইপ করার পদ্ধতিতে।

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-ai/DeepSeek-V4-Flash-0731","messages":[{"role":"user","content":"Say ready"}],"max_tokens":20}'

লক্ষ্য করুন কী অনুপস্থিত: model মানে কোনো openai/ নেই। সেই প্রিফিক্সটি OpenHands-এর জন্য, API-এর জন্য নয়। উত্তরটিতে prompt_tokens এবং completion_tokens সহ একটি usage ব্লক থাকে — একই দুটি সংখ্যা যা পরে আপনি একটি এজেন্ট সেশন জুড়ে যোগ হতে দেখবেন।

ভুল ফিল্ড কেমন দেখায়#

তিনটি ফিল্ডের প্রত্যেকটি কারণ হতে পারে:

• ভুল কী। API 401 উত্তর দেয় — কী অনুপস্থিত, ভুল টাইপ করা, বা কপি করার সময় শেষে একটি স্পেস আছে।
• ভুল Base URL। অনুরোধ ভুল জায়গায় যায় এবং আপনি 404 বা একটি সংযোগ ত্রুটি পান। ঠিকানাটি অবশ্যই /v1-এ শেষ হতে হবে এবং কোনো অতিরিক্ত পাথ থাকবে না।
• ভুল মডেল স্ট্রিং। হয় প্রিফিক্স অনুপস্থিত, অথবা এর পরে আইডিটি সম্পূর্ণ আইডি নয় (API শুধুমাত্র সম্পূর্ণ gateway_id গ্রহণ করে, deepseek-v4-flash-0731-এর মতো সংক্ষিপ্ত আইডি নয়)।

401 বনাম 404-এর সম্পূর্ণ যুক্তি API 401 or 404: wrong key, base URL or model id-এ আছে।

একটি সেশনে কত খরচ#

একটি এজেন্ট প্রতিটি ধাপে সম্পূর্ণ কনটেক্সটের জন্য বিল করে, আপনার এক-লাইনের কাজের জন্য নয়। ধরুন OpenHands একটি বাগ নিয়ে 40 ধাপ কাজ করে, প্রতি ধাপে প্রায় 30,000 টোকেন ইনপুট এবং 1,500 টোকেন আউটপুট লেখা হয়। DeepSeek-V4-Flash-এ এক ধাপ $0.0006; চল্লিশটি ধাপ নিচে, অন্য মডেল এবং OpenRouter-এর পাশে।

সামগ্রিকভাবে, ইনপুট এবং আউটপুট একসাথে গণনা করলে, এই ওয়ার্কলোডের জন্য DeepSeek-V4-Flash OpenRouter-এর চেয়ে সস্তা হয়। অনুমানগুলো আপনার পরিবর্তন করার জন্য: একটি ছোট ফিক্সে 10 ধাপ লাগতে পারে, একটি বড় রিফ্যাক্টরে 100। বর্তমান দাম pricing page-এ, এবং মডেল পৃষ্ঠা cheap DeepSeek।

ইতিমধ্যে অন্য প্রোভাইডারের সাথে OpenHands ব্যবহার করছেন?#

তাহলে আপনি শুধু তিনটি মান বদলাবেন: Custom Model, Base URL, API Key। প্রকল্পে আর কিছুই পরিবর্তন হয় না, এবং আপনি একইভাবে ফিরে যেতে পারেন। API-এর জন্য ধাপে ধাপে সংযোগ CheapTokens docs-এ আছে; ভিন্ন টুলে অনুরূপ সেটআপ হলো connect Aider।