API key کیا ہے اور اسے محفوظ طریقے سے کیسے رکھا جائے

آپ نے ایک AI API کے لیے سائن اپ کیا اور سب سے پہلے وہ ایک key مانگتی ہے۔ یہ گائیڈ بتاتی ہے کہ API key کیا ہے، کہاں سے آتی ہے، اسے محفوظ کیسے رکھا جائے اور اگر یہ کہیں پہنچ جائے جہاں نہیں پہنچنی چاہیے تو کیا کریں۔

API key کیا ہے#

API key حروف اور ہندسوں کی ایک لمبی سٹرنگ ہوتی ہے جو سروس کو بتاتی ہے کہ درخواست کون بھیج رہا ہے۔ اسے پروگراموں کے لیے پاس ورڈ سمجھیں: آپ کی اسکرپٹ ہر درخواست کے ساتھ key بھیجتی ہے، اور سروس اسے آپ کا اکاؤنٹ تلاش کرنے اور درخواست کی لاگت آپ کے بیلنس سے کاٹنے کے لیے استعمال کرتی ہے۔

اس سے دو باتیں لازم آتی ہیں:

• جس کے پاس key ہے وہ آپ کا بیلنس خرچ کر سکتا ہے۔ سروس آپ اور آپ کی key کاپی کرنے والے میں فرق نہیں کر سکتی۔
• key نہ ماڈل ہے نہ بیلنس۔ یہ صرف پاس ہے۔ بیلنس ایک الگ چیز ہے جسے آپ ٹاپ اپ کرتے ہیں، اور یہی key آپ کے اکاؤنٹ کے کسی بھی ماڈل کے ساتھ کام کرتی ہے۔

درخواست کی لاگت tokens میں شمار ہوتی ہے۔ اگر tokens آپ کے لیے نئی بات ہیں تو What is a token in AI? سے شروع کریں۔

key کہاں سے حاصل کریں#

ہر AI سروس اپنے ڈیش بورڈ سے keys جاری کرتی ہے۔ مثال کے طور پر، DeepSeek کی آفیشل API کا API keys صفحہ platform.deepseek.com/api_keys پر ہے، اور اس کی ڈاکس key کو DEEPSEEK_API_KEY environment variable سے پڑھتی ہیں (21 اکتوبر 2026 کو چیک کیا گیا)۔ عمومی طریقہ کار تقریباً ہر جگہ یکساں ہے:

1. اکاؤنٹ بنائیں۔
2. ڈیش بورڈ میں API keys صفحہ کھولیں۔
3. وہ بٹن دبائیں جو نئی key بناتا ہے اور اسے ایک نام دیں، مثلاً my-first-script۔
4. key فوراً کاپی کریں۔ بہت سی سروسز اسے صرف ایک بار دکھاتی ہیں۔

CheapTokens کے ساتھ، اکاؤنٹ سے key تک کے مراحل Your first API request with CheapTokens میں ہیں۔ CheapTokens پری پیڈ USD بیلنس سے کام کرتا ہے: تمام ماڈلز کے لیے ایک بیلنس۔ اگر بیلنس خالی ہونے کی وجہ سے درخواست ناکام ہو تو "Not enough tokens" error دیکھیں۔

key کہیں بھی نہیں ہونی چاہیے#

زیادہ تر لیک ہیک نہیں ہوتے۔ وہ کاپی پیسٹ کی غلطیاں ہیں:

• کوڈ (api_key="sk-...") میں براہ راست لکھی گئی key جو پھر GitHub پر پش کر دی جائے؛
• اسکرین شاٹ، چیٹ پیغام یا فورم پر سوال میں موجود key؛
• فرنٹ اینڈ کوڈ (ویب صفحہ یا موبائل ایپ) میں key: کوئی بھی اسے کھول کر پڑھ سکتا ہے؛
• ایک .env فائل جو git میں commit کر دی گئی ہو۔

آخری سب سے عام ہے۔ اگرچہ آپ اگلے commit میں فائل حذف کر دیں، key git ہسٹری میں رہ جاتی ہے، اس لیے جو key کبھی commit ہو چکی ہو اسے لیک شدہ ہی سمجھا جانا چاہیے۔

key کو environment variable میں رکھیں#

environment variable ایک نامزد ویلیو ہے جو آپ کے سسٹم میں رہتی ہے، آپ کے کوڈ میں نہیں۔ پروگرام اسے شروع ہوتے وقت پڑھتا ہے، اس لیے کوڈ محفوظ طریقے سے شیئر کیا جا سکتا ہے اور key آپ کی مشین پر رہتی ہے۔

Linux یا macOS میں، موجودہ ٹرمینل کے لیے اسے سیٹ کریں:

export CHEAPTOKENS_API_KEY="YOUR_API_KEY"

Windows PowerShell میں:

$env:CHEAPTOKENS_API_KEY = "YOUR_API_KEY"

یہ ٹرمینل بند کرنے تک برقرار رہتی ہے۔ سیشنز کے درمیان برقرار رکھنے کے لیے، لائن کو اپنے shell profile میں ڈالیں، یا پروجیکٹ کے لیے .env فائل استعمال کریں اور پہلے commit سے پہلے اسے .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
)

اگر variable موجود نہ ہو تو os.environ[...] پروگرام کو فوراً خرابی کے ساتھ روک دیتا ہے، جو خالی key کے ساتھ درخواست بھیجنے سے بہتر ہے۔

پہلی کال کریں#

CheapTokens OpenAI Chat Completions اور Anthropic Messages فارمیٹس بولتا ہے، اس لیے معیاری SDKs کام کرتے ہیں: آپ صرف 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 variable کی جگہ لے لیتا ہے اور 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}'

اس طرح کا مختصر ٹیسٹ سستا ہے۔ مثال کے طور پر، 1,000 input tokens اور 500 output tokens والی درخواست موجودہ قیمت پر $0.00013 کی لاگت رکھتی ہے۔ MiniMax-M2.7 میں 180K context بھی ہے اور یہ 8,192 tokens تک جوابات دیتا ہے، اس لیے یہ پہلے تجربات کے لیے آرام دہ ماڈل ہے۔ اگر جواب درمیان میں رک جائے تو Why does an AI answer stop mid-sentence? دیکھیں۔

ماڈل id کسی دوسری سروس کے بجائے CheapTokens ڈاکس سے کاپی کریں: ماڈل کے نام فراہم کنندگان کے درمیان مختلف ہوتے ہیں۔

key کو محفوظ رکھنے کی عادتیں#

• ہر پروجیکٹ کے لیے ایک key۔ اگر ایک لیک ہو جائے تو آپ صرف وہی تبدیل کرتے ہیں اور باقی کچھ کام کرنا نہیں رکتا۔
• keys کو ایسے نام دیں جو بتائیں کہ وہ کہاں استعمال ہوتی ہیں (laptop-script، telegram-bot)، تاکہ آپ کو معلوم ہو کہ تبدیلی کے بعد کیا اپ ڈیٹ کرنا ہے۔
• سیکھتے وقت بیلنس کم رکھیں۔ پری پیڈ بیلنس کے ساتھ، لیک شدہ key سے نقصان اس تک محدود ہوتا ہے جو اس پر موجود ہے، لیکن وہ بھی آپ کے پیسے ہیں۔
• keys لوگوں یا AI اسسٹنٹس کے ساتھ چیٹس میں نہ چسپاں کریں، اور انہیں لاگز اور اسکرین شاٹس سے کاٹ دیں۔
• key کو براؤزر یا موبائل ایپ میں نہ رکھیں۔ API کو ایسے سرور سے کال کریں جو آپ کے کنٹرول میں ہو، اور ایپ کو اسی سرور سے بات کرنے دیں۔

اگر key لیک ہو جائے تو کیا کریں#

اگر آپ نے key کسی عوامی ریپوزٹری پر پش کی، کسی پیغام میں بھیجی یا صرف یقین نہیں تو ایسے عمل کریں جیسے یہ پہلے ہی کسی اور کے ہاتھ میں ہو:

1. پہلے key منسوخ کریں۔ وہ صفحہ کھولیں جہاں آپ نے اسے بنایا تھا اور اسے حذف یا غیر فعال کریں۔ یہ سب سے پہلے کریں؛ صفائی بعد میں آتی ہے۔
2. نئی key بنائیں نئے نام کے ساتھ۔
3. اسے ہر جگہ تبدیل کریں جہاں یہ استعمال ہوتی تھی: environment variables، .env فائلیں، سرورز، ایپس اور ٹولز۔
4. اپنا بیلنس اور استعمال چیک کریں۔ وہ درخواستیں جو آپ نے نہیں بھیجیں، اس بات کی علامت ہیں کہ پرانی key استعمال ہوئی۔
5. سورس کی صفائی کریں۔ کوڈ سے key ہٹائیں اور .env کو .gitignore میں شامل کریں۔ فائل حذف کرنے سے key git ہسٹری سے نہیں جاتی، اسی لیے مرحلہ 1 ہسٹری دوبارہ لکھنے سے زیادہ اہم ہے۔

ترتیب اہم ہے۔ منسوخ شدہ key بے ضرر ہے چاہے وہ کسی پرانے commit میں رہ جائے۔

اگلے مراحل#

• key کے ساتھ اپنی پہلی درخواست کریں: Your first API request with CheapTokens۔
• سمجھیں کہ آپ کس چیز کی قیمت ادا کرتے ہیں: What is a token in AI?۔
• بیلنس ختم ہونے پر ٹاپ اپ کریں: "Not enough tokens" error۔

آزمانے کے لیے تیار ہیں؟ CheapTokens key حاصل کریں، اسے CHEAPTOKENS_API_KEY کے طور پر سیٹ کریں اور اوپر کی مثال چلائیں۔

ہر ماڈل کے endpoints، model ids اور limits CheapTokens docs میں ہیں۔