DeepSeek API key: কোথায় কী পেস্ট করবেন, এবং একটি প্রথম কল

একটি DeepSeek API key হলো একটি গোপন স্ট্রিং যা API-কে জানায় কে অনুরোধ পাঠাচ্ছে। তবে একটি টুলের কখনোই শুধু key দরকার হয় না: এর একসাথে তিনটি মান দরকার — key, base URL এবং model id। এই তিনটি সেট করুন এবং প্রথম কল কাজ করবে।

আপনি সম্ভবত এটি খুঁজেছেন কারণ কিছু ফর্ম আপনাকে "আপনার DeepSeek API key" চাইছে: একটি স্ক্রিপ্ট, একটি এডিটর প্লাগইন, একটি n8n নোড। ঠিক আছে। আসুন দেখি প্রতিটি ফিল্ড কী চায়, এবং তারপর একটি বাস্তব অনুরোধ পাঠাই।

API key আসলে কী?#

একটি হোটেলের কী কার্ডের কথা ভাবুন। এটি শব্দে বলে না আপনি কে; এটি শুধু আপনার দরজা খোলে এবং ফ্রন্ট ডেস্ক আপনার রুমের বিল করে। একটি API key একই কাজ করে: সার্ভার এটি অনুরোধে দেখে, জানে কোন অ্যাকাউন্টে চার্জ করতে হবে, এবং কলটি অনুমোদন করে। কার্ড হারালে যে কেউ ঢুকে আপনার রুমের বিল করতে পারে — তাই key কোড এবং চ্যাটের বাইরে রাখা হয়। (বিস্তারিত গল্পটি What is an API key and how to store it safely-এ আছে।)

DeepSeek-এর নিজস্ব API ডকুমেন্টেশন (৪ নভেম্বর ২০২৬-এ যাচাই করা) একই অভ্যাস দেখায়: কোনো উদাহরণ চালানোর আগে key একটি এনভায়রনমেন্ট ভেরিয়েবলে, DEEPSEEK_API_KEY, রাখা হয়, এবং API OpenAI ফরম্যাট অনুসরণ করে — api_key এবং base_url পরিবর্তন করলেই OpenAI SDK কাজ করে। এটাই পুরো কৌশল, এবং এজন্যই একটি key কখনো একা চলে না।

একটি বিষয় যা মানুষকে বিভ্রান্ত করে: একটি key সেই পরিষেবার যেটি এটি ইস্যু করেছে। একটি CheapTokens key CheapTokens-এর ঠিকানার সাথে যায়, এবং model id হলো সেটি যা CheapTokens তালিকাভুক্ত করে। এক জায়গার key অন্য জায়গার ঠিকানার সাথে মেশালে আপনি উত্তর নয়, একটি অনুমোদন ত্রুটি পাবেন।

key একটি এনভায়রনমেন্ট ভেরিয়েবলে রাখুন#

আপনার CheapTokens অ্যাকাউন্টে একটি key তৈরি করুন (ধাপগুলি docs-এ আছে) এবং ব্যালেন্স টপ আপ রাখুন যাতে অনুরোধের জন্য কিছু থাকে। তারপর key একটি ফাইলে পেস্ট না করে একটি ভেরিয়েবলে সংরক্ষণ করুন।

macOS বা Linux:

export CHEAPTOKENS_API_KEY='paste-your-key-here'

Windows PowerShell (শুধু বর্তমান উইন্ডো):

$env:CHEAPTOKENS_API_KEY = 'paste-your-key-here'

paste-your-key-here অংশটি একটি প্লেসহোল্ডার; আপনার আসল key আপনার নিজের টার্মিনালে সেখানে রাখুন এবং অন্য কোথাও নয়। কেন এটি হার্ড-কোডেড key-এর চেয়ে ভালো, এবং একটি লিক হলে কী করবেন, তা Store an API key safely: env variable, .gitignore, leak fix-এ আছে।

প্রথম অনুরোধ#

ধরুন আপনি শুধু এটি কাজ করতে দেখতে চান: মডেলকে এক বাক্যে একটি API key ব্যাখ্যা করতে বলুন। একই অনুরোধ, দুইভাবে — আপনি যে ট্যাব ব্যবহার করেন সেটি বেছে নিন।

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": "Explain an API key in one sentence."}],
    "max_tokens": 200
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['CHEAPTOKENS_API_KEY'],
    base_url='https://api.cheaptokens.dev/v1',
)

resp = client.chat.completions.create(
    model='deepseek-ai/DeepSeek-V4-Flash-0731',
    messages=[{'role': 'user', 'content': 'Explain an API key in one sentence.'}],
    max_tokens=200,
)

print(resp.choices[0].message.content)
print(resp.usage)

Python সংস্করণে একবার pip install openai দরকার। OpenAI SDK-এর জন্য লেখা একটি স্ক্রিপ্টের তুলনায় কী বদলেছে দেখুন: api_key, base_url এবং model — একই তিনটি মান। বাকি সব আগের মতোই থাকে।

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

উত্তরটি JSON। উত্তরের টেক্সট choices[0].message.content-এ থাকে; Python স্ক্রিপ্ট প্রথমে সেটিই প্রিন্ট করে। ঠিক পাশেই একটি usage ব্লক আছে যাতে prompt_tokens, completion_tokens এবং total_tokens — কত টোকেন ঢুকল, কত বেরোল, এবং যোগফল। এই দুটি সংখ্যা থেকে একটি খরচ গণনা করা হয়, এজন্যই প্রথম কলেও এগুলি এক নজর দেখার যোগ্য (Input vs output tokens বিভাজন ব্যাখ্যা করে)।

স্কেলের ধারণা পেতে: এইরকম একটি কল খুব ছোট। ৩০ টোকেন ইন এবং ২০০ আউট ধরুন — উদাহরণের max_tokens সীমা, তাই এই অনুরোধের সবচেয়ে ব্যয়বহুল কল। এর খরচ $0.00002। এরকম এক হাজার কল দেখতে এমন, সাথে রেফারেন্সের জন্য OpenRouter:

সেই id-এর পিছনে থাকা মডেলটি DeepSeek-V4-Flash: একটি 380K-টোকেন কনটেক্সট উইন্ডো এবং এক উত্তরে সর্বোচ্চ 32,768 টোকেন। যেকোনো সময়ে দাম একই, পিক-টাইম সারচার্জ নেই, এবং একটি ব্যালেন্স সব মডেল কভার করে। মোট — ইনপুট ও আউটপুট একসাথে — এটি OpenRouter-এর চেয়ে সস্তা, যা উপরের টেবিলে দেখানো হয়েছে। মডেল সম্পর্কে আরও: DeepSeek on CheapTokens, বর্তমান দাম pricing page-এ।

যখন কাজ করে না#

প্রায় প্রতিটি প্রথম-কল ব্যর্থতা তিনটি মানের একটি ভুল হওয়ার কারণে হয়। লক্ষণটি অপরাধীর সাথে মিলান:

এই ত্রুটিগুলির সম্পূর্ণ ওয়াকথ্রু API 401 or 404 error: wrong key, base URL or model id-এ আছে। এবং কোন id ব্যবহার করবেন তা নিশ্চিত না হলে, API-কেই জিজ্ঞাসা করুন: List models with GET /v1/models।

একই তিনটি মান পরবর্তীতে কোথায় যায়#

এগুলি একবার শেখার মূল বিষয় হলো এগুলি বহনযোগ্য। OpenAI-সামঞ্জস্যপূর্ণ API-এর সাথে কথা বলে এমন প্রায় যেকোনো টুলই কোনো না কোনো রূপে এই একই মানগুলি চায়: key, ঠিকানা এবং মডেল। একটি স্ক্রিপ্টে (LangChain, LiteLLM) এগুলি আর্গুমেন্ট; একটি অ্যাপ বা নো-কোড নোডে এগুলি ফিল্ড বা সেটিংস। আপনি কোড না লিখেও Postman-এ এগুলি চেষ্টা করতে পারেন। এই মডেলের সাথে স্ট্রিমিং এবং দীর্ঘ উত্তরগুলির জন্য, DeepSeek-V4-Flash quickstart দিয়ে চালিয়ে যান।