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 में platform.deepseek.com/api_keys पर API keys पेज है, और उसके docs 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 कभी कहाँ नहीं होनी चाहिए#

अधिकांश लीक हैक नहीं होते। वे कॉपी-पेस्ट की गलतियाँ होती हैं:

• key सीधे कोड में लिखी गई (api_key="sk-...") और फिर GitHub पर पुश कर दी गई;
• key किसी स्क्रीनशॉट, चैट संदेश या फोरम पर किसी प्रश्न में;
• key फ्रंट-एंड कोड में (कोई वेब पेज या मोबाइल ऐप): कोई भी उसे खोलकर पढ़ सकता है;
• .env फ़ाइल जो git में कमिट कर दी गई।

अंतिम वाली सबसे आम है। भले ही आप अगले कमिट में फ़ाइल हटा दें, key git इतिहास में रहती है, इसलिए जो key कभी कमिट हुई हो उसे लीक माना जाना चाहिए।

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 फ़ाइल का उपयोग करें और पहले कमिट से पहले इसे .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 docs से कॉपी करें: प्रदाताओं के बीच मॉडल नाम अलग होते हैं।

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 हानिरहित है, भले ही वह किसी पुराने कमिट में रह जाए।

अगले कदम#

• 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 और सीमाएँ CheapTokens docs में हैं।