पंजीकरण और API Key: 5 मिनट में TypeSafe कुंजी प्राप्त करें
पिछले पाठ में आप पहले ही जान चुके हैं कि Jev क्या है। इस पाठ में कुंजी हाथ में लें: TypeSafe पंजीकरण पूरा करें, कंसोल में जाकर एक Jev API Key बनाएं, उसे पर्यावरण चर में संग्रहीत करें, और फिर आधिकारिक Playground से सत्यापित करें कि वह सच में काम करती है — पूरी प्रक्रिया 5 मिनट में, एक भी लाइन कोड लिखे बिना।
सीखने के बाद आप क्या कर सकेंगे
- TypeSafe पंजीकरण पूरा करें, TypeSafe console कंसोल में लॉग इन करें
- कंसोल के Keys पेज पर एक Jev API Key बनाएं
- Key को पर्यावरण चर
TYPESAFE_API_KEYमें संग्रहीत करें, ताकि SDK स्वतः पढ़ ले - Playground से एक असली अनुरोध भेजें और पुष्टि करें कि Key काम करती है
- जानें कि रेट सीमा कहाँ देखें और सीमा पार होने पर क्या होगा
आपकी अभी की दुविधा
- Jev आज़माना चाहते हैं, लेकिन नहीं पता कि Key कहाँ से मिले: वेबसाइट, दस्तावेज़, कंसोल में ढेर सारे प्रवेश द्वार, आधे दिन घूमने के बाद भी बनाने की जगह नहीं मिली
- Key को कोड में कॉपी करके एक बार चला लिया, बाद में git में कमिट करते समय ठंडा पसीना आ गया
- सुना है कि रेट सीमा है, लेकिन नहीं पता आपका कोटा कितना है और पार होने पर क्या होगा
यह तरीका कब अपनाएं
जब आपको चाहिए:
- एक Jev API Key जो
api.typesafe.aiको कॉल कर सके - एक ऐसा तरीका जिससे बिना कोड लिखे पता चले कि Key काम करती है या नहीं
और आप नहीं करना चाहते:
- सीक्रेट कुंजी को साफ़ रूप में कोड या रिपॉज़िटरी में लिखना
- पहला अनुरोध चलाने से पहले पूरी API दस्तावेज़ पढ़ डालना
🎒 शुरू करने से पहले की तैयारी
- पिछला पाठ पढ़ चुके हों Jev क्या है, और जानते हों कि Jev का कॉल स्वरूप है 「state + प्रश्न」
- एक आधुनिक ब्राउज़र (पंजीकरण, Key बनाना, Playground से सत्यापन — सब कुछ ब्राउज़र में ही होता है)
- ऐसा नेटवर्क जो
console.typesafe.ai(कंसोल) औरapi.typesafe.ai(API) तक पहुँच सके
मूल विचार
कुंजी केवल एक है, प्रवेश द्वार केवल एक है। Jev के सभी कॉल — SDK, curl, Playground — एक ही API से होते हैं, और प्रमाणीकरण के लिए एक ही API Key उपयोग होती है। इसलिए प्रक्रिया बहुत छोटी है: पंजीकरण → कंसोल में Key बनाना → पर्यावरण चर में संग्रहीत करना → सत्यापन।
पर्यावरण चर में क्यों रखें। आधिकारिक रूप से स्पष्ट सलाह है: Key बनाने के बाद उसे पर्यावरण चर (जैसे TYPESAFE_API_KEY) में संग्रहीत करें। दो फ़ायदे:
- आधिकारिक SDK स्वतः यह चर पढ़ लेता है, कोड में एक भी सीक्रेट लिखने की ज़रूरत नहीं
- Key कोड फ़ाइल में नहीं आती, तो git कमिट के साथ बाहर नहीं जाती
TypeSafe console के तीन पेज, हर एक का अपना काम।
| पेज | पता | किस काम के लिए |
|---|---|---|
| Keys | console.typesafe.ai/keys | API Key बनाएं |
| Playground | console.typesafe.ai/playground | बिना कोड असली अनुरोध भेजें, Key सत्यापित करें |
| Rate limits | console.typesafe.ai/rate-limits | मौजूदा संगठन की रेट सीमा देखें |
एक अपेक्षा प्रबंधन। Jev अभी अर्ली एक्सेस चरण में है — वेबसाइट के मूल शब्द हैं 「Try our first System One Model, Jev, in early access」。कंसोल का इंटरफ़ेस संस्करण के साथ बदल सकता है, यह पाठ केवल आधिकारिक दस्तावेज़ में लिखे पते और प्रक्रिया को आधार बनाता है, इंटरफ़ेस का विवरण वास्तविक पेज के अनुसार मानें।
⚠️ चीन के उपयोगकर्ताओं के लिए ध्यान दें
आधिकारिक सूचना स्रोतों में चीनी नेटवर्क एक्सेस या युआन भुगतान के बारे में कोई जानकारी नहीं है, यह पाठ ऐसी सलाह नहीं देता जिसकी पुष्टि न हो सके; एक्सेस या भुगतान की समस्या आए तो TypeSafe के आधिकारिक पेज के संकेतों को मान्य मानें।
मेरे साथ करें
चरण 1: TypeSafe पंजीकरण पूरा करें, कंसोल में लॉग इन करें
क्यों: API Key केवल TypeSafe कंसोल में जारी की जाती है, पहले खाता होना ज़रूरी है।
ब्राउज़र में खोलें console.typesafe.ai, पेज के संकेतों के अनुसार पंजीकरण करें और लॉग इन करें।
आपको यह दिखना चाहिए: कंसोल इंटरफ़ेस में प्रवेश। वेबसाइट के नेविगेशन में इस प्रवेश द्वार को 「API console」 कहा गया है।
चरण 2: Keys पेज पर अपनी Jev API Key बनाएं
क्यों: आधिकारिक क्विक स्टार्ट के मूल शब्द हैं 「Get an API key from the TypeSafe console」, इससे मतलब इसी Keys पेज से है।
खोलें console.typesafe.ai/keys, पेज के संकेतों के अनुसार एक नई Key बनाएं।
आपको यह दिखना चाहिए: सीक्रेट कुंजी का एक टेक्स्ट। पहले उसे लोकल में कॉपी करके रख लें, अगले चरण में इस्तेमाल होगी।
- मैंने Key कॉपी कर ली, और उसे किसी भी कोड फ़ाइल में पेस्ट नहीं किया
चरण 3: Key को environment variable TYPESAFE_API_KEY में सहेजें
क्यों: आधिकारिक सिफ़ारिश है कि Key को environment variable में रखें; Python SDK स्वतः TYPESAFE_API_KEY को पढ़ लेता है, जिससे कोड में secret दिखाई नहीं देता।
आधिकारिक quick start का तरीका (macOS / Linux / Windows WSL का Bash):
export TYPESAFE_API_KEY="your-api-key"your-api-key की जगह वह secret स्ट्रिंग डालें जो आपने अभी कॉपी की है।
आपको यह दिखना चाहिए: कमांड चलने के बाद कोई आउटपुट नहीं आता—export सफल होने पर चुपचाप पूरा हो जाता है।
💡 यह कमांड केवल वर्तमान टर्मिनल के लिए मान्य है
export से सेट किया गया variable टर्मिनल बंद करने के बाद मिट जाता है; अगली बार नया टर्मिनल खोलने पर इसे दोबारा चलाना होगा। स्थायी समाधान के लिए इसे अपनी shell config फ़ाइल (जैसे ~/.bashrc) में जोड़ सकते हैं—यह सामान्य shell का उपयोग है, TypeSafe के आधिकारिक दस्तावेज़ में इसका ज़िक्र नहीं है।
- मैंने वर्तमान टर्मिनल में export चलाया, variable का नाम
TYPESAFE_API_KEYहै
चरण 4 : Playground से इस Key को सत्यापित करें
क्यों: कोड लिखने से पहले पक्का करें कि Key काम कर रही है—Playground ब्राउज़र से सीधे असली request भेजता है, कुछ भी इंस्टॉल नहीं करना पड़ता।
- console.typesafe.ai/playground खोलें और log in करें
- नीचे दिया गया आधिकारिक नमूना ticket state क्षेत्र में पेस्ट करें:
Our API integration started returning 500 errors on every request about 20 minutes ago, and we can't process any customer orders until this is fixed.- आधिकारिक नमूने का Noul प्रश्न जोड़ें:
{
"urgency": {
"type": "noul",
"instructions": "Does this message express urgency?"
}
}आपको यह दिखना चाहिए: 0 और 1 के बीच का एक probability संख्या लौटती है। संख्या मिल गई, तो समझें registration, Key, network—सब काम कर रहा है—यह चाबी उपयोगी है।
- मैंने Playground में 0–1 के बीच का एक नंबर प्राप्त किया
चरण 5 : अपनी rate limit एक नज़र देख लें
क्यों: Jev की rate limit organization के हिसाब से गिनी जाती है, सीमा पार करने वाले request 429 लौटाते हैं; पहले से पता हो कि quota कहाँ देखना है, तो आगे batch task चलाते समय अंदाज़ा रहता है।
console.typesafe.ai/rate-limits खोलें।
आपको यह दिखना चाहिए: वर्तमान organization की सीमा, प्रति सेकंड token संख्या (tokens/s) और प्रति सेकंड request संख्या (requests/s) दो आयामों में मापी जाती है।
चेकपॉइंट ✅
- मैं TypeSafe console में log in कर सकता हूँ, और मुझे पता है कि Key
/keysपेज पर बनती है - मेरी Key environment variable
TYPESAFE_API_KEYमें सहेजी गई है, कोड में नहीं लिखी - मैंने Playground में इस Key से 0–1 की probability प्राप्त की है
- मुझे पता है कि rate limit
/rate-limitsपेज पर देखी जाती है, सीमा पार होने पर429लौटता है - मुझे पता है कि आधिकारिक SDK स्वतः
TYPESAFE_API_KEYपढ़ता है
सावधानी की याद दिलाना
❌ Key को कोड में hardcode करना या git में commit करना
Secret एक बार repository में घुस गई, तो commit हटा देने से भी बात नहीं बनती—लीक हुई Key कोई भी लेकर आपका quota जला सकता है। सही तरीका: environment variable TYPESAFE_API_KEY में रखें (आधिकारिक सिफ़ारिश), कोड में केवल TypeSafeClient(model="jev-latest") लिखें, SDK खुद पढ़ लेगा।
❌ Request से 401 लौटना
401 = Key गायब या अमान्य। क्रम से तीन जगहें जाँचें: वर्तमान टर्मिनल में export किया है या नहीं; variable का नाम TYPESAFE_API_KEY ही है क्या (पूरा uppercase, वर्तनी गलत न हो); कॉपी की गई Key में कोई अतिरिक्त content तो नहीं। आधिकारिक SDK Key के शुरू-आख़िर की whitespace (newline सहित) हटा देता है, लेकिन Key के भीतर space, control character या non-ASCII character होने पर सीधे reject हो जाती है।
❌ Request से 429 लौटने पर समझना कि Key खराब हो गई
429 = rate limit ट्रिगर हुई, Key की समस्या नहीं। सीमा organization के हिसाब से है (tokens/s + requests/s), /rate-limits पेज पर quota देखें। आधिकारिक SDK डिफ़ॉल्ट रूप से स्वतः retry करता है (प्रतीक्षा समय हर बार लंबा होता जाता है, और retry-after response header का पालन करता है); केवल सीधे HTTP API से जुड़ने पर खुद संभालना पड़ता है। अधिक quota चाहिए तो custom / enterprise plan लें, आधिकारिक application form उपलब्ध है।
❌ Console में रास्ता भटकना
तीन पेज याद रखना काफ़ी है: /keys से Key बनाएँ, /playground से Key आज़माएँ, /rate-limits से limit देखें—address bar में सीधे URL टाइप करना सबसे तेज़ है।
उन्नत तरीके (वैकल्पिक)
Coding agent के लिए भी यही Key configure करें। आधिकारिक agent skill दस्तावेज़ में स्पष्ट कहा गया है: एक API Key बनाएँ, अपने coding agent को permission दें, और सस्ते test call से वह खुद TypeSafe के सर्वोत्तम उपयोग खोज ले। आधिकारिक तौर पर तैयार prompt भी दिया गया है—「मेरी TYPESAFE_API_KEY में export की गई Key से कुछ experiment चलाओ, सबसे आशाजनक परिणामों के आधार पर बदलाव सुझाओ」。Claude Code के साथ विकास पाठ के TypeSafe skill के साथ, agent सीधे आपके लिए Jev कॉल करने वाला कोड लिख सकता है।
Key और क़ीमत का संबंध। यह Key Jev को token के हिसाब से bill करती है—input भुगतान वाला, output मुफ़्त। दरें, model संस्करण और context सीमाओं की पूरी तालिका मॉडल और क़ीमत पेज पर है।
इस पाठ का सारांश
✅ TypeSafe registration पूरी: आपके पास TypeSafe console खाता है, Key /keys पेज पर बनती है।
✅ Key तैयार: environment variable TYPESAFE_API_KEY में सहेजी, आधिकारिक SDK स्वतः पढ़ता है, कोड में zero secret।
✅ Key सत्यापित: Playground में असली probability मिल चुकी है; rate limit कहाँ देखनी है पता है—/rate-limits।
मुख्य configuration field की समीक्षा:
| Field | अनुशंसित मान | विवरण |
|---|---|---|
TYPESAFE_API_KEY | आपकी Key (environment variable) | आधिकारिक सिफ़ारिश का तरीका; Python SDK स्वतः पढ़ता है |
| Key निर्माण पेज | console.typesafe.ai/keys | Console का Keys पेज |
| Playground | console.typesafe.ai/playground | बिना कोड Key सत्यापन, प्रश्न प्रकार आज़माना |
| Rate limit पेज | console.typesafe.ai/rate-limits | organization के हिसाब से: tokens/s + requests/s, सीमा पार होने पर 429 |
अगले पाठ की झलक
चाबी हाथ में आ गई, अगले पाठ में इसे उपयोग करें: Python SDK इंस्टॉल कर पहला request भेजें: 10 मिनट में पूरा।
आप सीखेंगे:
- venv + pip से typesafe-sdk इंस्टॉल करना (Python 3.10+)
- आधिकारिक ticket तीन-प्रश्न नमूना चलाना, एक ही बार में classification, score, हाँ-नहीं तीनों उत्तर पाना
- response में
probabilitiesऔरconfidenceसमझना - इंस्टॉल न हो या न चले तो पहले कहाँ देखें