DeepSeek API key: कहाँ क्या पेस्ट करें, और एक पहली कॉल

एक DeepSeek API key एक गुप्त स्ट्रिंग है जो API को बताती है कि अनुरोध कौन भेज रहा है। हालाँकि, किसी टूल को अकेले key की कभी ज़रूरत नहीं होती: उसे तीन मान एक साथ चाहिए — key, base URL और model id। ये तीनों सेट करें और पहली कॉल काम कर जाएगी।

आपने यह शायद इसलिए खोजा क्योंकि कोई फ़ॉर्म आपसे "आपकी DeepSeek API key" माँग रहा है: कोई स्क्रिप्ट, एडिटर प्लगइन, n8n नोड। ठीक है। आइए देखें कि हर फ़ील्ड क्या चाहती है, और फिर एक असली अनुरोध भेजें।

API key असल में क्या है?#

होटल की key card की तरह सोचें। वह शब्दों में नहीं बताती कि आप कौन हैं; वह बस आपका दरवाज़ा खोलती है और फ्रंट डेस्क आपके कमरे का बिल बनाता है। API key वही काम करती है: सर्वर उसे अनुरोध में देखता है, जानता है कि किस खाते से शुल्क लेना है, और कॉल को पास होने देता है। कार्ड खो गया तो कोई भी अंदर आकर आपके कमरे का बिल बना सकता है — इसलिए key को कोड से बाहर और चैट से बाहर रखा जाता है। (विस्तृत कहानी What is an API key and how to store it safely में है।)

DeepSeek के अपने API दस्तावेज़ (4 नवंबर 2026 को जाँचे गए) यही आदत दिखाते हैं: कोई भी उदाहरण चलाने से पहले key एक environment variable, DEEPSEEK_API_KEY, में जाती है, और API OpenAI फ़ॉर्मैट का पालन करती है — api_key और base_url बदलते ही OpenAI SDK काम करता है। यही पूरी तरकीब है, और इसीलिए key कभी अकेली नहीं चलती।

एक बात जो लोगों को उलझा देती है: key उसी सेवा की होती है जिसने उसे जारी किया। CheapTokens की key CheapTokens के पते के साथ जाती है, और model id वही होता है जो CheapTokens सूचीबद्ध करता है। एक जगह की key को दूसरी जगह के पते के साथ मिलाएँ तो जवाब नहीं, authorization error मिलेगा।

key को environment variable में रखें#

अपने CheapTokens खाते में एक key बनाएँ (चरण docs में हैं) और बैलेंस भरा रखें ताकि अनुरोध के पास निकालने के लिए कुछ हो। फिर key को किसी फ़ाइल में पेस्ट करने के बजाय एक variable में रखें।

macOS या Linux:

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

Windows PowerShell (केवल वर्तमान विंडो):

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

paste-your-key-here वाला हिस्सा एक placeholder है; अपनी असली key वहाँ अपने ही टर्मिनल में रखें और कहीं नहीं। यह hard-coded 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 हैं — कितने tokens अंदर गए, कितने बाहर आए, और उनका योग। इन दो संख्याओं से लागत निकाली जाती है, इसीलिए पहली कॉल पर भी इन पर एक नज़र डालना फ़ायदेमंद है (Input vs output tokens इस विभाजन को समझाता है)।

पैमाने का अंदाज़ा लगाने के लिए: ऐसी कॉल बहुत छोटी होती है। 30 tokens अंदर और 200 बाहर लें — उदाहरण की max_tokens सीमा, यानी इस अनुरोध की सबसे महँगी कॉल। इसकी लागत $0.00002 है। ऐसी हज़ार कॉल इस तरह दिखती हैं, संदर्भ के लिए OpenRouter साथ में:

उस id के पीछे का मॉडल DeepSeek-V4-Flash है: 380K-token का context window और एक उत्तर में अधिकतम 32,768 tokens। कीमत किसी भी घंटे एक जैसी है, peak-time का कोई अतिरिक्त शुल्क नहीं, और एक बैलेंस हर मॉडल के लिए चलता है। कुल मिलाकर — input और output दोनों मिलाकर — यह 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-compatible API से बात करता है, यही मान किसी न किसी रूप में माँगता है: key, पता और मॉडल। स्क्रिप्ट (LangChain, LiteLLM) में ये arguments होते हैं; किसी ऐप या no-code नोड में ये फ़ील्ड या settings होते हैं। आप इन्हें बिना कोड लिखे Postman में भी आज़मा सकते हैं। इस मॉडल के साथ streaming और लंबे उत्तरों के लिए, DeepSeek-V4-Flash quickstart के साथ आगे बढ़ें।