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 دستاویزات (4 نومبر 2026 کو چیک کی گئی) یہی عادت دکھاتی ہیں: کوئی بھی مثال چلانے سے پہلے key ایک ماحولیاتی متغیر DEEPSEEK_API_KEY میں جاتی ہے، اور API OpenAI فارمیٹ کی پیروی کرتی ہے — OpenAI SDK کام کرتا ہے جب آپ api_key اور base_url تبدیل کر لیں۔ یہی پورا راز ہے، اور اسی لیے 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 تقسیم کی وضاحت کرتا ہے)۔

پیمانے کا اندازہ لگانے کے لیے: اس جیسی کال بہت چھوٹی ہے۔ 30 ٹوکن اندر اور 200 باہر لیں — مثال کی 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 کے ساتھ جاری رکھیں۔