API key কী এবং কীভাবে এটি নিরাপদে সংরক্ষণ করবেন

আপনি একটি AI API-তে সাইন আপ করেছেন এবং প্রথমেই এটি একটি key চায়। এই গাইডে ব্যাখ্যা করা হয়েছে API key কী, এটি কোথা থেকে আসে, কীভাবে এটি নিরাপদে রাখবেন এবং এটি ভুল জায়গায় চলে গেলে কী করবেন।

API key কী#

একটি API key হলো অক্ষর ও সংখ্যার একটি দীর্ঘ স্ট্রিং, যা সার্ভিসকে জানায় কে একটি request পাঠাচ্ছে। এটিকে প্রোগ্রামের জন্য পাসওয়ার্ড ভাবুন: আপনার স্ক্রিপ্ট প্রতিটি request-এর সাথে key পাঠায়, এবং সার্ভিস এটি ব্যবহার করে আপনার অ্যাকাউন্ট খুঁজে বের করে এবং আপনার ব্যালেন্স থেকে request-এর খরচ কেটে নেয়।

এ থেকে দুটি বিষয় অনুসরণ করে:

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

একটি request-এর খরচ টোকেনে গণনা করা হয়। টোকেন যদি আপনার কাছে নতুন হয়, What is a token in AI? দিয়ে শুরু করুন।

key কোথায় পাবেন#

প্রতিটি AI সার্ভিস তার নিজস্ব ড্যাশবোর্ড থেকে key ইস্যু করে। উদাহরণস্বরূপ, DeepSeek-এর অফিসিয়াল API-তে platform.deepseek.com/api_keys-এ একটি API keys পেজ আছে, এবং এর ডকস DEEPSEEK_API_KEY এনভায়রনমেন্ট ভেরিয়েবল থেকে key পড়ে (২১ অক্টোবর ২০২৬-এ যাচাই করা)। সাধারণ প্রবাহ প্রায় সর্বত্র একই:

1. একটি অ্যাকাউন্ট তৈরি করুন।
2. ড্যাশবোর্ডে API keys পেজ খুলুন।
3. নতুন key তৈরি করার বোতাম চাপুন এবং এটির একটি নাম দিন, উদাহরণস্বরূপ my-first-script।
4. সাথে সাথেই key কপি করুন। অনেক সার্ভিস এটি শুধু একবার দেখায়।

CheapTokens-এর সাথে, অ্যাকাউন্ট থেকে key পর্যন্ত ধাপগুলো Your first API request with CheapTokens-এ আছে। CheapTokens প্রিপেইড USD ব্যালেন্স থেকে কাজ করে: সব মডেলের জন্য একটি ব্যালেন্স। ব্যালেন্স খালি থাকার কারণে request ব্যর্থ হলে, "Not enough tokens" error দেখুন।

key কখনোই যেখানে থাকা উচিত নয়#

বেশিরভাগ লিক হ্যাক নয়। এগুলো কপি-পেস্টের ভুল:

• কোডে (api_key="sk-...") সরাসরি লেখা key এবং তারপর GitHub-এ পুশ করা;
• স্ক্রিনশট, চ্যাট মেসেজ বা ফোরামে প্রশ্নে থাকা key;
• ফ্রন্ট-এন্ড কোডে (একটি ওয়েব পেজ বা মোবাইল অ্যাপ) থাকা key: যে কেউ এটি খুলে পড়তে পারে;
• git-এ কমিট করা একটি .env ফাইল।

শেষটি সবচেয়ে সাধারণ। পরের কমিটে ফাইলটি মুছে ফেললেও, key git ইতিহাসে থেকে যায়, তাই একবার কমিট করা key-কে লিক হয়েছে বলে ধরে নিতে হবে।

key একটি এনভায়রনমেন্ট ভেরিয়েবলে সংরক্ষণ করুন#

এনভায়রনমেন্ট ভেরিয়েবল হলো একটি নামযুক্ত মান যা আপনার সিস্টেমে থাকে, আপনার কোডে নয়। প্রোগ্রামটি শুরু হওয়ার সময় এটি পড়ে, তাই কোড নিরাপদে শেয়ার করা যায় এবং key আপনার মেশিনেই থাকে।

Linux বা macOS-এ, বর্তমান টার্মিনালের জন্য এটি সেট করুন:

export CHEAPTOKENS_API_KEY="YOUR_API_KEY"

Windows PowerShell-এ:

$env:CHEAPTOKENS_API_KEY = "YOUR_API_KEY"

এটি টার্মিনাল বন্ধ না করা পর্যন্ত থাকে। সেশনগুলোর মধ্যে এটি রাখতে, লাইনটি আপনার shell প্রোফাইলে রাখুন, অথবা প্রজেক্টের জন্য একটি .env ফাইল ব্যবহার করুন এবং প্রথম কমিটের আগে এটি .gitignore-এ যোগ করুন:

# .gitignore
.env

তারপর কোডে key পড়ুন। কখনোই সেখানে টাইপ করবেন না:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],  # read from the environment, not written in the code
)

ভেরিয়েবলটি অনুপস্থিত থাকলে, os.environ[...] সাথে সাথেই একটি ত্রুটি দিয়ে প্রোগ্রাম বন্ধ করে দেয়, যা খালি key দিয়ে request পাঠানোর চেয়ে ভালো।

প্রথম কল করুন#

CheapTokens OpenAI Chat Completions এবং Anthropic Messages ফরম্যাটে কথা বলে, তাই স্ট্যান্ডার্ড SDK-গুলো কাজ করে: আপনি শুধু base URL এবং key পরিবর্তন করেন। এখানে MiniMaxAI/MiniMax-M2.7 দিয়ে একটি সম্পূর্ণ পরীক্ষা:

import os
from openai import OpenAI

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

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "Explain what an API key is in two sentences."}],
    max_tokens=200,
)

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

curl দিয়ে একই, যেখানে shell ভেরিয়েবলটি প্রতিস্থাপন করে এবং key কখনোই কমান্ডে দেখা যায় না:

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": "Hello"}], "max_tokens": 100}'

এমন একটি ছোট পরীক্ষা সস্তা। উদাহরণস্বরূপ, ১,০০০ ইনপুট টোকেন এবং ৫০০ আউটপুট টোকেনের একটি request বর্তমান মূল্যে $0.00013 খরচ করে। MiniMax-M2.7-এ 180K কনটেক্সটও আছে এবং এটি ৮,১৯২ টোকেন পর্যন্ত উত্তর দেয়, তাই প্রথম পরীক্ষার জন্য এটি একটি আরামদায়ক মডেল। উত্তর মাঝপথে থেমে গেলে, Why does an AI answer stop mid-sentence? দেখুন।

মডেল id অন্য সার্ভিস থেকে নয়, CheapTokens ডকস থেকে কপি করুন: প্রদানকারীদের মধ্যে মডেলের নাম ভিন্ন হয়।

key নিরাপদ রাখার অভ্যাস#

• প্রতি প্রজেক্টে একটি key। একটি লিক হলে, আপনি শুধু সেটিই প্রতিস্থাপন করেন এবং আর কিছুই কাজ করা বন্ধ করে না।
• key-গুলোকে এমন নাম দিন যা বলে সেগুলো কোথায় ব্যবহৃত হয় (laptop-script, telegram-bot), যাতে প্রতিস্থাপনের পরে কী আপডেট করতে হবে তা আপনি জানেন।
• শেখার সময় ব্যালেন্স ছোট রাখুন। প্রিপেইড ব্যালেন্সের সাথে, লিক হওয়া key থেকে ক্ষতি এর মধ্যে থাকা পরিমাণে সীমাবদ্ধ, তবে সেটি এখনও আপনার টাকা।
• মানুষ বা AI সহায়কদের সাথে চ্যাটে key পেস্ট করবেন না, এবং লগ ও স্ক্রিনশট থেকে সেগুলো কেটে ফেলুন।
• ব্রাউজার বা মোবাইল অ্যাপে key রাখবেন না। আপনার নিয়ন্ত্রণাধীন একটি সার্ভার থেকে API কল করুন, এবং অ্যাপটিকে সেই সার্ভারের সাথে কথা বলতে দিন।

key লিক হলে কী করবেন#

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

1. প্রথমে key প্রত্যাহার করুন। যে পেজে এটি তৈরি করেছিলেন সেটি খুলুন এবং এটি মুছুন বা নিষ্ক্রিয় করুন। অন্য কিছুর আগে এটি করুন; পরিষ্কার করা পরে আসে।
2. একটি নতুন নাম দিয়ে একটি নতুন key তৈরি করুন।
3. এটি যেখানেই ব্যবহৃত হয়েছিল সেখানে প্রতিস্থাপন করুন: এনভায়রনমেন্ট ভেরিয়েবল, .env ফাইল, সার্ভার, অ্যাপ এবং টুল।
4. আপনার ব্যালেন্স এবং ব্যবহার পরীক্ষা করুন। আপনি যে request করেননি সেগুলো পুরোনো key ব্যবহৃত হওয়ার লক্ষণ।
5. সোর্স পরিষ্কার করুন। কোড থেকে key সরান এবং .gitignore-এ .env যোগ করুন। ফাইল মুছে ফেললে git ইতিহাস থেকে key সরে যায় না, এজন্যই ইতিহাস পুনর্লিখনের চেয়ে ধাপ ১ বেশি গুরুত্বপূর্ণ।

ক্রমটি গুরুত্বপূর্ণ। প্রত্যাহার করা key ক্ষতিকর নয়, এমনকি এটি একটি পুরোনো কমিটে থাকলেও।

পরবর্তী ধাপ#

• একটি key দিয়ে আপনার প্রথম request করুন: Your first API request with CheapTokens।
• আপনি কীসের জন্য অর্থ দেন তা বুঝুন: What is a token in AI?।
• ব্যালেন্স শেষ হলে টপ আপ করুন: "Not enough tokens" error।

চেষ্টা করতে প্রস্তুত? একটি CheapTokens key নিন, এটি CHEAPTOKENS_API_KEY হিসেবে সেট করুন এবং উপরের উদাহরণটি চালান।

প্রতিটি মডেলের endpoint, মডেল id এবং সীমা CheapTokens docs-এ আছে।