📘 CodingMarble Learn

AI टूल का उपयोग और Python कोड से AI API कॉल करना

AI टूल बना-बनाया ऐप है (चैट, चित्र, आवाज़, अनुवाद) जिसे आप टाइप करके या दबाकर इस्तेमाल करते हैं। AI API से आपका अपना प्रोग्राम वैसी ही AI सेवा से मदद माँग सकता है। प्रोग्राम अनुरोध भेजता है (पता, गुप्त चाबी और JSON में प्रश्न) और उत्तर पाता है (स्टेटस कोड और JSON में जवाब)। Python में requests लाइब्रेरी से यह लगभग छह पंक्तियों में होता है। अच्छा उपयोग यानी साफ़ प्रॉम्प्ट, उत्तर की जाँच, चाबी की सुरक्षा और ख़र्च व सीमा का ध्यान।

🎬 कदम-दर-कदम कहानी

  1. आप चैट AI टूल खोलकर प्रश्न लिखते हैं। AI उत्तर भेजता है। यहाँ माँगने वाला इंसान है। नारंगी अनुरोध जाता और हरा उत्तर लौटता देखिए।
  2. अलग काम के लिए अलग टूल: लिखने के लिए चैट AI, चित्र के लिए इमेज AI, ज़ोर से पढ़ने के लिए वॉइस AI, भाषा के लिए अनुवाद AI। कोई काम दबाइए, सही टाइल चमकेगी।
  3. अब आपका अपना प्रोग्राम माँगना चाहता है। रेस्तराँ सोचिए। प्रोग्राम ग्राहक है, API वेटर है जो ऑर्डर ले जाता है, और AI सेवा रसोई है जो व्यंजन बनाती है।
  4. ये रहीं कोड की छह पंक्तियाँ। चरण-दर-चरण चलाइए: तैयारी, प्रश्न लिखना, भेजना, उत्तर पढ़ना। हर चरण एक पंक्ति चमकाता है।
  5. चाबी घर की चाबी जैसी है: गुप्त रखिए। हर कॉल पर थोड़ा ख़र्च भी है और सीमा भी, इसलिए छोटे अनुरोध से जाँचिए। लाल पट्टी दिखाती है कि कॉल कैसे जमा होते हैं।
  6. खुला खेल। अनुरोध भेजकर उत्तर पढ़िए, या ग़लत चाबी लगाकर देखिए कि द्वार 401 त्रुटि के साथ "ना" कहता है।

टिप: 3D दृश्य को घुमाने के लिए खींचें। ज़ूम के लिए दो उंगलियाँ इस्तेमाल करें।

🤔 आम शंकाएँ और उनके जवाब

AI टूल और उसकी API में क्या फ़र्क़ है?

टूल में इंसान टाइप करता है। API में आपके लिए प्रोग्राम टाइप करता है। पहले चरण (इंसान) की तुलना रेस्तराँ तस्वीर वाले प्रोग्राम से कीजिए।

कैसे जानें कि कौन सा AI टूल इस्तेमाल करूँ?

काम से टूल मिलाइए: पाठ, चित्र, आवाज़ या अनुवाद। 3D में हर काम दबाइए और टाइल को चमकते देखिए।

API को वेटर क्यों कहते हैं?

क्योंकि आप कभी रसोई में नहीं जाते। API तय रूप में आपका ऑर्डर लेता है और नतीजा लाकर देता है।

कोड की हर पंक्ति क्या करती है?

3D में चारों चरण चलाइए: तैयारी (पंक्ति 1–3), डेटा (4), भेजना (5), पढ़ना (6)। चमकती पंक्ति बताती है कि कौन सी चल रही है।

चाबी गुप्त क्यों रखूँ और सोच-समझकर कॉल क्यों करूँ?

चाबी वाला कोई भी आपके खाते से काम करके आपका पैसा ख़र्च कर सकता है। कॉल की सीमाएँ भी हैं; लाल पट्टी उन्हें जमा होते दिखाती है।

जब मैं आज़माता हूँ तो 401 का क्या मतलब है?

चाबी ग़लत थी इसलिए द्वार ने अनुरोध ठुकरा दिया। खुले खेल में "ग़लत चाबी आज़माइए" दबाकर देखिए।

AI प्लेटफ़ॉर्म और टूल: ये क्या हैं

AI टूल ऐसा ऐप है जो प्रशिक्षित AI मॉडल से आपका काम करता है। AI प्लेटफ़ॉर्म बड़ी सेवा है जहाँ आप कई मॉडल इस्तेमाल कर सकते हैं, परख सकते हैं और, डेवलपर हों तो, अपने प्रोग्राम से जोड़ सकते हैं।

AI टूल का अच्छा उपयोग

आप जो प्रश्न लिखते हैं उसे प्रॉम्प्ट कहते हैं। अच्छा प्रॉम्प्ट बताता है: AI कौन बने, क्या काम करे, और किस रूप में (जैसे "कक्षा 6 के बच्चे को बारिश तीन छोटी पंक्तियों में समझाओ")।

  1. उत्तर जाँचिए। AI पूरे भरोसे से बोलकर भी ग़लत हो सकता है। किताब या शिक्षक से मिलाइए।
  2. निजी जानकारी बचाइए। पासवर्ड, पहचान संख्या या दूसरों की निजी बातें न चिपकाइए।
  3. ईमानदार रहिए। होमवर्क में AI ने मदद की हो तो बताइए, और उत्तर से सीखिए, सिर्फ़ नक़ल मत कीजिए।
  4. सही टूल चुनिए। पाठ वाला AI कैलकुलेटर नहीं है और इमेज AI तथ्य जाँचने वाला नहीं।

API क्या है? वेटर वाली तस्वीर

API (एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस) नियमों का समूह है जिससे एक प्रोग्राम दूसरे से कुछ माँग सके। रेस्तराँ वाली तस्वीर में: आपका प्रोग्राम = ग्राहक, API = वेटर, AI सेवा = रसोई। आप रसोई में नहीं जाते; तय रूप में वेटर को ऑर्डर देते हैं और व्यंजन लौटता है।

ज़्यादातर AI सेवाएँ वेब API देती हैं। आप इंटरनेट पर एक पते (URL, जिसे एंडपॉइंट भी कहते हैं) पर अनुरोध भेजते हैं और उत्तर पाते हैं। डेटा अक्सर JSON में चलता है, यानी सरल पाठ-रूप जैसे {"prompt": "hello"}।

Python में API कॉल करना

सामान्य Python लाइब्रेरी requests है। कॉल के चार भाग हैं: चाबी (Key), पता (URL), डाटा (Data), भेजना (Send)।

import requests
key = "YOUR_SECRET_KEY"
url = "https://api.example.com/v1/chat"   # उदाहरण पता, असली नहीं
data = {"prompt": "Explain rain in one line"}
reply = requests.post(url, json=data, headers={"Authorization": "Bearer " + key})
print(reply.json()["answer"])

असली सेवाओं के पते और फ़ील्ड के नाम अलग होते हैं; उनका दस्तावेज़ पढ़िए और ऊपर के उदाहरण की नक़ल नहीं, ढाँचा अपनाइए।

चाबी, त्रुटियाँ, ख़र्च और सीमाएँ

चाबी सुरक्षित रखिए। उसे ऐसे कोड में मत लिखिए जो आप साझा या अपलोड करें। उसे एनवायरनमेंट वेरिएबल में रखिए और os.environ["AI_KEY"] से पढ़िए।

त्रुटियाँ सँभालिए। नेटवर्क फ़ेल होते हैं। टाइमआउट लगाइए और स्टेटस जाँचिए:

try:
    reply = requests.post(url, json=data, headers=h, timeout=10)
    reply.raise_for_status()      # 401, 429, 500 पर रुक जाता है
    print(reply.json()["answer"])
except requests.RequestException as e:
    print("AI सेवा तक नहीं पहुँचे:", e)

ख़र्च और सीमाएँ। कई सेवाएँ हर अनुरोध पर या पाठ की मात्रा (टोकन) पर पैसे लेती हैं और प्रति मिनट अनुरोधों की सीमा रखती हैं। छोटे प्रॉम्प्ट से जाँचिए और अंतहीन लूप में कॉल मत कीजिए।

करके देखिए

3D के खुले खेल चरण में तीनों अनुरोध भेजिए, फिर "ग़लत चाबी आज़माइए" दबाइए। पढ़ने से पहले स्टेटस कोड का अनुमान लगाइए। फिर कॉपी में छह पंक्तियों का कोड याद से लिखिए और सही पंक्तियों के आगे चा, प, डा, भे लिखिए।

घर पर बड़ों के साथ: कोई असली AI टूल आज़माइए। पहले अस्पष्ट प्रॉम्प्ट लिखिए, फिर कौन-क्या-रूप वाला साफ़ प्रॉम्प्ट, और उत्तरों की तुलना कीजिए।

मुख्य सूत्र और परिभाषाएँ

हल किए गए उदाहरण

1. कोड पंक्ति reply = requests.post(url, json=data, headers=h) का हर भाग क्या करता है?

requests.post POST अनुरोध भेजता है; url पता है; json=data प्रश्न को JSON में भेजता है; headers=h चाबी ले जाता है। reply में लौटा उत्तर रखा जाता है।

2. किसी प्रोग्राम को स्टेटस 401 मिला। सबसे संभावित समस्या और उपाय क्या है?

चाबी ग़लत, ग़ायब या पुरानी है। Authorization हेडर और चाबी का मान जाँचिए, फिर दोबारा कोशिश कीजिए।

3. एक सेवा प्रति मिनट 60 अनुरोध की अनुमति देती है। लूप हर 0.5 सेकंड पर एक अनुरोध भेजता है। क्या होगा?

हर 0.5 s पर एक यानी प्रति मिनट 120, जो 60 से ज़्यादा है। लगभग 30 सेकंड बाद 429 त्रुटियाँ आने लगेंगी। कॉल के बीच कम से कम 1 सेकंड रुकना जोड़िए।

4. "बारिश के बारे में बताओ" को बेहतर प्रॉम्प्ट में बदलिए।

जैसे: "तुम कक्षा 6 के विज्ञान शिक्षक हो। बारिश कैसे बनती है, एक रोज़मर्रा के उदाहरण के साथ तीन छोटी पंक्तियों में समझाओ।" इसमें कौन, क्या और किस रूप में तीनों हैं।

आम गलतियाँ

अभ्यास क्विज़

1. रेस्तराँ वाली तस्वीर में API क्या है?
2. स्टेटस कोड 401 का आम अर्थ है:
3. वेब API कॉल करने के लिए Python की कौन सी लाइब्रेरी आम है?
4. API चाबी को सुरक्षित कहाँ रखना चाहिए?
5. reply.json() क्या करता है?

अभ्यास: खुद जवाब दो

अपना जवाब लिखो या चुनो, फिर जाँचें दबाओ। अटको तो संकेत देखो; जवाब देने के बाद पूरा हल दिखेगा।

अक्सर पूछे जाने वाले प्रश्न

AI टूल और AI API में क्या अंतर है?

टूल ऐसा ऐप है जिसे आप हाथ से (टाइप या क्लिक करके) चलाते हैं। API से आपका अपना प्रोग्राम वैसी ही AI सेवा अपने-आप इस्तेमाल करता है, अनुरोध भेजकर और उत्तर पढ़कर।

AI API कॉल करने के लिए क्या AI आना ज़रूरी है?

नहीं। बस अनुरोध भेजना और उत्तर पढ़ना आना चाहिए: पता, चाबी, JSON डेटा और जवाब। AI ख़ुद सेवा पर चलता है।

क्या अपनी API चाबी कोड में रखना सुरक्षित है?

अगर आप कोड साझा या अपलोड करते हैं तो नहीं। चाबी एनवायरनमेंट वेरिएबल या ऐसी निजी सेटिंग फ़ाइल में रखिए जिसे आप कभी साझा न करें।

यह कहाँ पढ़ाया जाता है

चीन高一Comp.1 Ch.4 Intelligent era

पहले यह पढ़ें

आगे पढ़ें

इससे जुड़े पाठ

सभी कंप्यूटर विज्ञान पाठ