curl और Python के साथ AI API कुंजी का परीक्षण कैसे करें

यहाँ बताया गया है कि कुछ भी बनाए बिना ai api कुंजी एक्सेस का परीक्षण कैसे करें: तीन अनुरोध, लगभग दो मिनट, और आपको पता चल जाएगा कि कुंजी मान्य है, फंडेड है और टेक्स्ट जनरेट करने के लिए अनुमत है।
मुख्य बिंदु
- सबसे पहले GET /v1/models कॉल करें: यह साबित करता है कि कुंजी स्वीकार की गई है बिना क्रेडिट खर्च किए।
- मॉडल uncensored को एक छोटा चैट अनुरोध भेजें ताकि पुष्टि हो सके कि जनरेशन काम कर रहा है।
- X-Balance-USD हेडर या GET /v1/balance पढ़ें ताकि यह देख सकें कि क्या शेष है।
- 401 कुंजी की ओर इशारा करता है, 402 बैलेंस की ओर, 429 आपके अनुरोध दर की ओर।
तीन-कॉल टेस्ट
एक AI API कुंजी का उचित परीक्षण करने के लिए आपको तीन अलग-अलग बातें साबित करनी होंगी: सर्वर कुंजी को स्वीकार करता है, कुंजी के पीछे क्रेडिट है, और एक वास्तविक पूर्णता वापस आती है। प्रत्येक प्रश्न के लिए एक अनुरोध रखने से निदान सरल रहता है। यदि कुछ विफल होता है, तो आपको पता चलता है कि कौन सी परत दोषी है।
- मॉडल लिस्ट। कुंजी की प्रमाणीकरण करता है और इसकी कोई लागत नहीं होती।
- चैट पूर्णता। पुष्टि करता है कि मॉडल उत्तर देता है और आपका अनुरोध प्रारूप सही है।
- बैलेंस। परीक्षण के बाद शेष राशि की पुष्टि करता है।
नीचे दिया गया सब कुछ बेस URL https://api.aiapisource.com/v1 और मॉडल ID uncensored का उपयोग करता है। अपनी कुंजी को एक पर्यावरण चर में डालें ताकि वह कभी भी आपके शेल इतिहास या रिपॉजिटरी में न आए।
export AIAPI_KEY="paste-your-key-here"
यदि आपके पास अभी तक कोई कुंजी नहीं है, तो API कुंजी पृष्ठ दिखाता है कि एक कैसे बनाएं। नए खातों के पास एक क्लिक से $0.50 का मुफ़्त ट्रायल क्रेडिट दावा करने का विकल्प होता है, जो इस लेख में हर परीक्षण के लिए पर्याप्त है।
चरण 1: curl के साथ मॉडल सूची
सबसे सस्ता चेक एक रीड-ओनली अनुरोध है। GET /v1/models मॉडल सूची लौटाता है और एक मान्य कुंजी की आवश्यकता होती है, इसलिए एक सफल जवाब प्रमाणीकरण को साबित करता है।
curl -s https://api.aiapisource.com/v1/models \
-H "Authorization: Bearer $AIAPI_KEY"
एक स्वस्थ प्रतिक्रिया JSON होती है जिसमें data सरणी होती है जिसमें uncensored शामिल होता है। यदि आपको एक HTML पेज, कनेक्शन त्रुटि या खाली प्रतिक्रिया दिखती है, तो समस्या URL में है, कुंजी में नहीं। जांचें कि आपने /v1 सफ़िक्स बनाए रखा है और आपके वेरिएबल में कुंजी के बाद कोई ट्रेलिंग स्पेस नहीं है।
-i को curl कमांड में जोड़ें ताकि आप response headers देख सकें। API हर call पर X-Request-Id भेजता है। उस मान को रखें यदि आप कभी सहायता से संपर्क करते हैं, क्योंकि वह सटीक request को पहचानता है।
चरण 2: एक चैट अनुरोध भेजें
अब जनरेशन जांचें। प्रॉम्प्ट को छोटा रखें और आउटपुट को कैप करें ताकि टेस्ट की लागत एक सेंट के अंश से कम रहे।
curl -s https://api.aiapisource.com/v1/chat/completions \
-H "Authorization: Bearer $AIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the single word: ready"}],
"max_tokens": 10
}'
choices[0].message.content और usage ऑब्जेक्ट की तलाश करें जिसमें prompt_tokens और completion_tokens हों। लगभग 20 इनपुट टोकन और 5 आउटपुट टोकन वाले एक अनुरोध की लागत 20 / 1,000,000 x $0.15 प्लस 5 / 1,000,000 x $0.50 होती है, जो लगभग $0.0000055 है। आप इनमें से सौ चला सकते हैं, जो एक सेंट से भी कम में आएगा।
वही एंडपॉइंट स्ट्रीमिंग के लिए भी काम करता है: "stream": true जोड़ें और टोकन सर्वर-सेंट इवेंट्स के रूप में आते हैं। बेसिक कॉल काम करने के बाद इसे अलग से टेस्ट करें।
चरण 3: Python में वही परीक्षण
यदि आपका वास्तविक कोड एक OpenAI SDK का उपयोग करता है, तो SDK के माध्यम से भी परीक्षण करें। यह उन समस्याओं को पकड़ता है जिन्हें curl नहीं पकड़ सकता, जैसे कि गलत तर्क के लिए आधार URL पास करना।
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIAPI_KEY"],
base_url="https://api.aiapisource.com/v1",
)
print([m.id for m in client.models.list().data])
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the single word: ready"}],
max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)
पहली प्रिंट एक सूची दिखाएगी जिसमें uncensored शामिल है। दूसरा मॉडल की प्रतिक्रिया दिखाता है। SDK सेटअप के लिए एक लंबे मार्गदर्शक के लिए, इस साइट पर OpenAI API Python गाइड देखें।
पायथन संस्करण को उसी शेल से चलाएं जहाँ आपने कुंजी एक्सपोर्ट की थी। यदि यह AIAPI_KEY पर KeyError फेंकता है, तो उस सत्र में वेरिएबल सेट नहीं है, जो नेटवर्क तक पहुँचने से पहले टेस्ट फेल होने का सबसे आम कारण है।
Node भी उसी तरह काम करता है: OpenAI क्लाइंट कन्स्ट्रक्टर को baseURL: "https://api.aiapisource.com/v1" और कुंजी पास करें।
बैलेंस जाँचें
एक कुंजी मान्य हो सकती है और फिर भी खर्च करने के लिए कुछ न हो। बैलेंस पढ़ने के दो तरीके:
curl -s https://api.aiapisource.com/v1/balance \
-H "Authorization: Bearer $AIAPI_KEY"
# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
-H "Authorization: Bearer $AIAPI_KEY"
हर प्रतिक्रिया में X-Balance-USD हेडर भी होता है, इसलिए चरण 2 से चैट कॉल ने आपको शेष क्रेडिट बता दिया था यदि आपने -i के साथ इसे चलाया था। Python में, OpenAI SDK इसे client.chat.completions.with_raw_response.create(...) के माध्यम से प्रकट करता है, जहाँ आप response.headers["X-Balance-USD"] पढ़ते हैं।
असफल या अस्वीकृत अनुरोधों के लिए चार्ज नहीं किया जाता है, इसलिए एक परीक्षण जो त्रुटि देता है वह क्रेडिट नहीं खाता। प्रीपेड क्रेडिट समाप्त नहीं होता, जिसका अर्थ है कि एक उपयोग न किए गए बैलेंस को अगले सप्ताह भी वहाँ मिल जाएगा।
त्रुटि कोड पढ़ना
जब एक परीक्षण विफल होता है, तो HTTP स्थिति कारण को जल्दी संकीर्ण कर देती है।
| कोड | सामान्य अर्थ | क्या करना है |
|---|---|---|
| 401 | कुंजी गायब है, गलत टाइप की गई है या रद्द कर दी गई है | Authorization: Bearer हेडर की जाँच करें, कुंजी को फिर से कॉपी करें, छिपे हुए स्पेस या कोट्स के लिए देखें |
| 402 | अनुरोध के लिए भुगतान करने के लिए कोई क्रेडिट नहीं बचा है | बैलेंस पढ़ें, फिर मूल्य निर्धारण पृष्ठ पर टॉप-अप करें |
| 404 | गलत पथ या गलत मॉडल आईडी | /v1/chat/completions और मॉडल uncensored का उपयोग करें |
| 429 | रेट या कंकरेंसी लिमिट, या छोटा ओवरलोड | प्रतीक्षा करें और पुनः प्रयास करें; नीचे देखें |
429 एक त्रुटि कोड ले जाता है। rate_limited का मतलब प्रति मिनट बहुत सारे अनुरोध हैं और concurrency का मतलब एक साथ बहुत सारे अनुरोध हैं। एक पूर्ण कुंजी प्रति मिनट 300 अनुरोध और 8 समानांतर अनुरोध की अनुमति देती है; एक ट्रायल कुंजी प्रति मिनट 60 और एक साथ 2 की अनुमति देती है। अस्थायी ओवरलोड पर API 429 Retry-After: 5 के साथ जवाब देता है, इसलिए पांच सेकंड प्रतीक्षा करें और अनुरोध फिर से भेजें। एक स्ट्रीम किए गए अनुरोध अपनी कॉन्करेंसी स्लॉट को स्ट्रीम समाप्त होने तक धारण करता है, जो समानांतर टेस्ट के दौरान ट्रायल कुंजी के लिमिट पर पहुँचने का एक सामान्य कारण है।
स्थिति कोड 401, 402 और 404 सामान्य API अनुपालन का पालन करते हैं, इसलिए तालिका को एक प्रारंभिक अनुमान के रूप में मानें और सटीक संदेश के लिए JSON त्रुटि बॉडी पढ़ें।
एक पुन: उपयोग योग्य स्मोक-टेस्ट स्क्रिप्ट
एक बार जब मैन्युअल परीक्षण पास हो जाता है, तो एक स्क्रिप्ट रखें जिसे आप कुंजियों को घुमाने या वातावरण बदलने के बाद चला सकते हैं।
import os, sys
import requests
BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}
m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)
c = requests.post(
BASE + "/chat/completions",
headers=H,
json={"model": "uncensored",
"messages": [{"role": "user", "content": "ping"}],
"max_tokens": 5},
timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)
Exit code से deploy check में आना आसान हो जाता है। इस न्यूनतम से आगे के parameters के लिए, API दस्तावेज़ में endpoint द्वारा स्वीकृत हर चीज़ की सूची है।
अधिक गाइड
प्रश्न और उत्तर
क्या API कुंजी का परीक्षण करने में पैसा लगता है?
मॉडल सूची को कॉल करना मुफ़्त है। एक छोटी चैट अनुरोध जिसमें कम max_tokens होता है, $0.15 प्रति 1M इनपुट टोकन और $0.50 प्रति 1M आउटपुट टोकन की दर से एक डॉलर के कुछ मिलियनवें भाग का खर्च आता है। असफल अनुरोधों के लिए चार्ज नहीं किया जाता है।
मैं बिना कार्ड के कुंजी का परीक्षण कैसे करूँ?
साइन अप करने के बाद API कुंजी पृष्ठ पर $0.50 ट्रायल क्रेडिट क्लेम करें। इसके लिए कार्ड की आवश्यकता नहीं है और यह 7 दिनों के लिए मान्य है, एक व्यक्ति के लिए एक।
एक मान्य कुंजी तुरंत 429 क्यों देती है?
शायद आपने समानांतरता या प्रति-मिनट रेट लिमिट को छू लिया है। ट्रायल कुंजियाँ 2 समानांतर अनुरोध और प्रति मिनट 60 की अनुमति देती हैं; फुल कुंजियाँ 8 और 300 की अनुमति देती हैं। त्रुटि कोड की जाँच करें, फिर कुछ सेकंड बाद गति कम करें या पुनः प्रयास करें।
क्या मैं curl के बजाय Postman या किसी ऐप में कुंजी का परीक्षण कर सकता हूँ?
हाँ। कोई भी OpenAI-संगत क्लाइंट काम करता है: मूल URL को https://api.aiapisource.com/v1 पर सेट करें, कुंजी को Bearer टोकन के रूप में पेस्ट करें और मॉडल uncensored का उपयोग करें।
आपकी कुंजी के लिए बस एक प्रपत्र भरना बाकी है
एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।