कोड के बिना शुरुआत
आप अपनी API कुंजी दिए बिना इस साइट के स्वतंत्र मुफ़्त डेमो में अपना पाठ और सवाल आज़मा सकते हैं। हाँ/नहीं का नियम बनाएँ या 2–6 विकल्प तय करें। Jev को अपने ऐप से जोड़ने के लिए नीचे दिया गया अलग आधिकारिक TypeSafe खाता और API पहुँच का रास्ता अपनाएँ।
डेमो में पाठ, सवाल, नियम और विकल्प मिलाकर कुल 10,000 वर्ण की सीमा है, जो Unicode कोड पॉइंट के रूप में गिने जाते हैं। यह साइट की सीमा है, Jev की कॉन्टेक्स्ट विंडो नहीं। लाइव जाँच में मानव सत्यापन की ज़रूरत पड़ सकती है और उपयोग या बजट की सीमा पर जाँच रुक सकती है। टेम्पलेट लोड करने से वह चलता नहीं और मॉडल का परिणाम पहले से नहीं भरता।
कस्टम संपादक खोलें · फ़ीडबैक वर्गीकरण टेम्पलेट लोड करें
1. पहुँच पाने के सही रास्ते से शुरुआत करें
17 सितंबर 2026 की स्थिति में TypeSafe की सार्वजनिक वेबसाइट पर प्रतीक्षा-सूची है। आधिकारिक त्वरित शुरुआत में Playground और API के निर्देश दिए गए हैं। दस्तावेज़ों का कोई पृष्ठ खुलने का अर्थ यह नहीं है कि हर खाते को मॉडल तक पहुँच मिली हुई है।
- यदि आपको पहुँच नहीं मिली है: TypeSafe की आधिकारिक वेबसाइट की प्रतीक्षा-सूची का उपयोग करें। यह साइट खातों को स्वीकृति नहीं दे सकती और न ही API कुंजियाँ जारी कर सकती है।
- यदि आपके खाते को पहुँच मिली है: TypeSafe कंसोल खोलें और उसमें Playground या API कुंजी बनाने की प्रक्रिया अपनाएँ।
खातों की उपलब्धता और शुरुआती सेटअप की प्रक्रिया बदल सकती है। अपने खाते की स्थिति आधिकारिक कंसोल में देखें।
2. एक सीमित प्रश्न आज़माएँ
Playground में एक छोटा काल्पनिक संदेश इनपुट के रूप में दें और एक Noul प्रश्न पूछें। उदाहरण के लिए, वापस फ़ोन करने का अनुरोध करने वाला संदेश लें और पूछें कि क्या वापस फ़ोन करने का स्पष्ट अनुरोध है। फिर इनपुट को मदद के किसी अस्पष्ट अनुरोध से बदलें और देखें कि परिणाम बदलता है या नहीं।
यह व्यवहार को समझने का अभ्यास है, सटीकता का परीक्षण नहीं। शुरुआत में दो विपरीत उदाहरण लेने से आपको समझने में मदद मिलती है कि आपका प्रश्न उसी अंतर को व्यक्त कर रहा है या नहीं जिसे आप पहचानना चाहते थे।
Jev दी गई जानकारी को state कहता है। यह एक स्ट्रिंग, JSON ऑब्जेक्ट या ऐरे हो सकती है। अधिक जटिल कामों में नाम वाले फ़ील्ड इस्तेमाल करें, ताकि संदेश, सहायक रिकॉर्ड और संबंधित नीति अलग-अलग पहचाने जा सकें। इनपुट के प्रारूप
डेवलपर के लिए
3. पहला API अनुरोध करें
दस्तावेज़ में दिया गया एंडपॉइंट POST https://api.typesafe.ai/v1/systemone है। यह मॉडल का नाम, state और नाम वाले प्रश्न स्वीकार करता है। प्रमाणीकरण के लिए bearer token का उपयोग होता है। API संदर्भ
अपने स्थानीय परिवेश में TYPESAFE_API_KEY को सुरक्षित ढंग से सेट करें, फिर हमारा यह उदाहरण टर्मिनल में चलाएँ:
तकनीकी जानकारी देखें
curl --fail-with-body --silent --show-error \
https://api.typesafe.ai/v1/systemone \
-H "Authorization: Bearer $TYPESAFE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "jev-latest",
"state": "Please call me tomorrow morning to discuss the setup.",
"questions": {
"callback_requested": {
"type": "noul",
"instructions": "Does the sender explicitly ask for a phone call?"
}
}
}
JSONसफल उत्तर में answers.callback_requested.noul और usage.input_tokens पढ़ें। उत्तर के फ़ील्ड
Noul, उत्तर हाँ होने की अनुमानित प्रायिकता व्यक्त करता है। Noul का अर्थ
कुंजियाँ अपने टर्मिनल या सर्वर परिवेश में रखें। उन्हें ब्राउज़र JavaScript, सार्वजनिक रिपॉज़िटरी, स्क्रीनशॉट या साझा उदाहरण में न डालें। यह मार्गदर्शिका कभी आपसे वेबसाइट में कुंजी चिपकाने को नहीं कहती।
4. काम की ज़रूरत के अनुसार ही संरचना बढ़ाएँ
जब अगला कदम किसी श्रेणी पर निर्भर हो तो Choice, अर्थपूर्ण क्रमबद्ध स्तर हों तो Score, और हाँ या नहीं की प्रायिकता चाहिए तो Noul का उपयोग करें। एक ही state से जुड़े स्वतंत्र प्रश्न साथ में जोड़ें; उनके परिणामों को अपने अनुप्रयोग में सँभालें।
एक ठोस अगला कदम जानने के लिए सहायता टिकट का उदाहरण देखें। इसमें दिखाया गया है कि दस्तावेज़ में दिया गया आउटपुट कैसे रूटिंग के प्रस्ताव में बदला जा सकता है।
5. पहुँच और अनुरोध की समस्याएँ अलग-अलग जाँचें
यदि कंसोल में लॉगिन पूरा नहीं होता, तो आधिकारिक कंसोल को उसके सामान्य प्रवेश बिंदु से फिर खोलें और जाँचें कि आप उसी खाते का उपयोग कर रहे हैं जिसे पहुँच मिली है। ब्राउज़र की लॉगिन समस्या हल करने के लिए बार-बार API अनुरोध बदलने से बचें। सफल लॉगिन भी यह स्थापित नहीं करता कि API कुंजी जारी हो चुकी है। खाते से जुड़ी मदद चाहिए तो TypeSafe का आधिकारिक सहायता माध्यम इस्तेमाल करें; सार्वजनिक रिपोर्ट में कभी कुंजी या लॉगिन लिंक शामिल न करें।
HTTP अनुरोध में प्रश्न बदलने से पहले स्टेटस और त्रुटि के विवरण की जाँच करें:
| लक्षण | आगे क्या जाँचें |
|---|---|
401 उत्तर |
कुंजी और bearer प्रमाणीकरण हेडर की पुष्टि करें |
422 उत्तर |
लौटाया गया सत्यापन विवरण पढ़ें और अनुरोध के फ़ील्ड जाँचें |
429 उत्तर |
अनुरोधों का दबाव घटाएँ और विराम बढ़ाते हुए फिर प्रयास करें |
529 उत्तर |
इसे अस्थायी अतिभार मानें और विराम बढ़ाते हुए फिर प्रयास करें |
ये कोड API संदर्भ में दिए गए हैं। 429 या 529 के लिए घातीय बैकऑफ़ अपनाएँ, यानी हर दोबारा प्रयास के बीच प्रतीक्षा का समय बढ़ाएँ। SDK सामान्य सेटिंग में पहले से दोबारा प्रयास करते हैं; बाहर एक और पुनःप्रयास चक्र जोड़ने से पहले इन प्रयासों को भी गिनें।
समय समाप्त हो जाना, नकारात्मक उत्तर मिलने से अलग है। कुल समय-सीमा और प्रयासों की सीमित संख्या तय करें, फिर अनसुलझे काम को समीक्षा के लिए भेजें। यह सुनिश्चित करें कि मॉडल अनुरोध दोहराने से आगे की कोई कार्रवाई, जैसे काम का आवंटन बनाना, दोबारा न हो जाए।
6. अप्रत्याशित उत्तर की जाँच करें
| आपको क्या दिख रहा है | उपयोगी जाँच |
|---|---|
| गलत प्रश्न का वैध उत्तर | सटीक निर्देशों की तुलना इच्छित शर्त से करें; अपवाद स्पष्ट लिखें |
| संपादन के बाद परिणाम बदलता है | मॉडल संस्करण, state, विकल्पों के लेबल, क्रम और मूल्यांकन मानदंड साथ में सुरक्षित रखें |
| स्कोर दो स्तरों के बीच आता है | उसे भारित स्थिति समझें, पूर्णांक लेबल या सटीक मात्रा नहीं |
| कमज़ोर साक्ष्य पर मज़बूत परिणाम | जाँचें कि state में वास्तव में क्या है; विश्वास-मान गायब रिकॉर्ड उपलब्ध नहीं करा सकता |
| दो उत्तर परस्पर असहमत हैं | हर प्रश्न अलग जाँचें और मतभेद सँभालने की नीति कोड में तय करें |
ये हमारी संपादकीय समस्या-जाँच की सलाहें हैं। Score की मार्गदर्शिका भिन्नात्मक मान समझाती है; हमारा सीमाओं वाला पृष्ठ विक्रेता की वर्तमान सावधानियों और अलग से चिह्नित सामुदायिक अवलोकनों के लिंक देता है।
jev-latest उपनाम किसी नए मॉडल की ओर बदल सकता है। परीक्षण करते समय उत्तर में मिला मॉडल पहचानकर्ता दर्ज करें; जब परिणाम दोहराना महत्त्वपूर्ण हो, तो अपने खाते में समर्थित संस्करण-विशिष्ट पहचानकर्ता इस्तेमाल करें। मॉडल उपनाम
7. तय करें कि पहली कार्यप्रक्रिया तैयार है या नहीं
स्वचालित कार्रवाइयाँ चालू करने से पहले अपेक्षित निर्णयों का एक छोटा संग्रह रखें, गलतियों की समीक्षा करें और अपनी कार्यप्रक्रिया के लिए सीमा-मान चुनें। इनपुट-टोकन पर खर्च का अनुमान लगाने के लिए मूल्य कैलकुलेटर और किन कामों को दूसरे टूल के पास रखना चाहिए यह तय करने के लिए तुलना मार्गदर्शिका का उपयोग करें।
स्रोत और आगे की पढ़ाई
यह मार्गदर्शिका आधिकारिक दस्तावेज़ों और लिंक की गई सामुदायिक रिपोर्टों पर आधारित है। समुदाय के अवलोकनों का श्रेय उनके लेखकों को दिया गया है।
- TypeSafe तक पहुँच और प्रतीक्षा-सूची
- आधिकारिक त्वरित शुरुआत
- HTTP API संदर्भ
- State और इनपुट के प्रारूप
- मॉडल और उनके उपनाम