AI शिक्षा केंद्रराष्ट्रीय परिवर्तन दल मुफ़्त सीखना शुरू करें →

होम › सभी पाठ › प्रो धारा — बिल्डर व इंजीनियर

🛎️ AI API से अपना पहला प्रोजेक्ट

API की घंटी बजाना सीखिए — key की सुरक्षा से लेकर पहले demo तक

इंजीनियरिंग/टेक की राह पर

API क्या है? दरवाज़े की घंटी से समझिए

सोचिए आप किसी बड़ी building के गेट पर खड़े हैं। अंदर की मशीनरी आपको नहीं दिखती — आप बस घंटी दबाते हैं, और अंदर से जवाब आता है। API (Application Programming Interface) ठीक यही घंटी है: एक तय तरीका जिससे आपका code किसी और के software से बात करता है। AI API में वो 'अंदर वाला software' एक बहुत बड़ा AI model है जो कंपनी के servers पर चलता है। आपको महंगा GPU खरीदने की ज़रूरत नहीं — बस घंटी बजाना (request भेजना) आना चाहिए। दुनिया का लगभग हर AI app अंदर से यही कर रहा है।

Request → Response: पूरा flow

  1. आपका code एक HTTP request बनाता है — उसमें आपका prompt (सवाल/message) और आपकी API key होती है।
  2. Request internet के ज़रिए provider के server तक जाती है, जहाँ model उसे process करता है।
  3. Server जवाब JSON में लौटाता है — JSON यानी data का structured डिब्बा, जिसे code आसानी से पढ़ लेता है।
  4. आपका code JSON में से text निकालकर user को दिखा देता है। बस — हर AI app के अंदर यही चार कदम बार-बार चल रहे हैं।

API key: चाबी भी, पहचान भी

API key एक लंबी secret string होती है — कुछ ऐसी दिखती है: sk-a1b2c3d4... — जो provider के dashboard से मिलती है (ज़्यादातर में free sign-up के बाद)। हर request के साथ यह key जाती है, ताकि server जान सके कि call किसने की और usage किसके account में गिनी जाए। यानी key चाबी भी है और आपकी पहचान भी — जिसके पास आपकी key है, वो आपके नाम पर और आपके account के पैसे/credits पर calls कर सकता है।

Terminal में export AI_API_KEY="aapki-key" चलाकर key को environment variable बनाइए, फिर code में os.environ से पढ़िए। नियम एक line का है: code public हो सकता है, key कभी नहीं। यही छोटी-सी professional आदत आपको भीड़ से अलग करती है।

5-6 लाइन में आपकी पहली API call

import requests, os | key = os.environ["AI_API_KEY"] | url = "https://api.example-ai.com/v1/chat" | data = {"model": "chat-model", "messages": [{"role": "user", "content": "नमस्ते! एक line में अपना परिचय दो।"}]} | r = requests.post(url, headers={"Authorization": "Bearer " + key}, json=data) | print(r.json()) — (हर | एक नई line है; यह generic pattern है, किसी एक कंपनी का नहीं।)

समझिए क्या हो रहा है: url किसी भी AI provider का endpoint है (उनके docs में लिखा होता है), headers में Bearer के साथ आपकी key जाती है, messages में आपका सवाल, और r.json() में model का जवाब आता है। Python के बिना भी test कर सकते हैं — terminal में curl command से वही request एक line में चली जाती है। Provider बदलने पर सिर्फ़ url और model का नाम बदलता है — pattern हर जगह यही रहता है। यही असली बात है: एक pattern सीखा, तो सारे AI APIs सीख लिए।

Free tier और rate limits — 429 से दोस्ती

ज़्यादातर providers सीखने के लिए free tier या free credits देते हैं — छोटा demo बनाने के लिए काफ़ी, कई जगह बिना card के भी शुरुआत हो जाती है। लेकिन हर key पर rate limit होती है: एक minute या दिन में इतनी requests, इतने tokens. Limit पार करते ही server 429 (Too Many Requests) error देता है। इसका इलाज simple है — कुछ seconds रुककर retry करें, loop में लगातार calls न ठोकें। अच्छे apps इसे 'retry with backoff' कहकर code में handle करते हैं। 429 आना गलती नहीं है, उसे handle न करना गलती है।

Idea से demo तक — एक हफ़्ते का रास्ता

  1. एक छोटा idea चुनिए जो आपकी अपनी दुनिया से हो — जैसे 'फ़सल का सवाल पूछो, आसान हिंदी में जवाब पाओ' या 'English sentence सुधारने वाला helper'.
  2. एक page पर input और output लिख लीजिए: user क्या डालेगा, app क्या लौटाएगा। यही आपका design document है।
  3. ऊपर वाली 5-6 line script से API call चलाकर test कीजिए कि जवाब सही आ रहा है — पहले prompt को ठीक कीजिए, फिर code को।
  4. Simple interface बनाइए — शुरुआत में terminal ही काफ़ी है, बाद में एक HTML page जोड़ लीजिए।
  5. किसी दोस्त या घरवाले से इस्तेमाल करवाइए — जहाँ वो अटकें, वहीं आपका अगला सुधार है।
  6. Demo की video या link portfolio/GitHub में डालिए (key हटाकर!). ऐसे real demos से internship या freelance काम मिलना संभव है — गारंटी नहीं, पर बिना demo वाले CV से आप बहुत आगे होंगे। AI आपका helper है, समझ और मेहनत आपकी ही चलेगी।
❝ मैं Python में किसी AI chat API को call करने वाला beginner हूँ। requests library से एक POST request का छोटा example लिखो जिसमें API key environment variable से आए, और फिर हर line आसान हिंदी में समझाओ। ❞→ AI आपको चलने लायक script देगा और line-by-line बताएगा कि headers, JSON body और response में क्या हो रहा है।❝ मेरे API code में 429 error आ रहा है। समझाओ यह क्यों आता है और मेरी script में simple retry (कुछ seconds रुककर दोबारा try) कैसे जोड़ूँ — code के साथ। ❞→ AI rate limit का कारण समझाएगा और time.sleep वाला retry loop जोड़कर सुधरा हुआ code देगा।

इस पाठ को इंटरैक्टिव तरीके से सीखिए

अभ्यास, क्विज़, सुनने की सुविधा और आपके नाम का प्रमाणपत्र — सब मुफ़्त, बिना इंटरनेट भी चलता है।

यह पाठ खोलें →

इसे आज़माएँ — तैयार प्रॉम्प्ट

यह प्रॉम्प्ट कॉपी करके किसी भी AI ऐप में पूछिए:

मैं AI API सीख रहा/रही हूँ। मुझे Python में एक छोटा script लिखकर दो जो किसी भी generic AI chat API को call करे — API key environment variable AI_API_KEY से ले, user का message terminal से पूछे, और model का जवाब print करे। फिर (1) हर line आसान हिंदी में समझाओ, (2) बताओ कि key को code में hardcode करना क्यों खतरनाक है, और (3) 429 rate-limit error के लिए simple retry कैसे जोड़ें।

अपनी समझ जाँचिए

आपकी API key गलती से public GitHub repo में commit हो गई। सबसे सही कदम क्या है?

  • कुछ नहीं — किसी ने देखा नहीं होगा
  • Repo को private कर देना ही काफ़ी है
  • Dashboard से key तुरंत revoke करके नई key बनाना
  • Key को code में comment करके छिपा देना

सही उत्तर: Dashboard से key तुरंत revoke करके नई key बनाना

Bots public repos को minutes में scan कर लेते हैं, और commit history में key वैसे भी बची रहती है — repo private करने या comment करने से कुछ नहीं होता। Leak होते ही key revoke करके नई बनाना ही एकमात्र सही इलाज है।

API call पर 429 error आया। इसका मतलब और सही जवाब क्या है?

  • Key गलत है — नई key खरीदनी पड़ेगी
  • Rate limit पार हो गई — कुछ seconds रुककर retry करें
  • Server हमेशा के लिए बंद हो गया
  • Internet काम नहीं कर रहा

सही उत्तर: Rate limit पार हो गई — कुछ seconds रुककर retry करें

429 (Too Many Requests) बताता है कि आपने तय limit से ज़्यादा requests भेज दीं। थोड़ा रुककर retry करना — retry with backoff — ही सही तरीका है; लगातार calls ठोकना नहीं।

इसी विषय के और पाठ

← बिना Coding के AI Automationओपन-सोर्स AI: बराबरी का मैदान →