API प्लेग्राउंड
इंटरैक्टिवअपनी key से ब्राउज़र में हर मॉडल और endpoint आज़माएँ — स्ट्रीमिंग आउटपुट, रिक्वेस्ट इंस्पेक्टर और जनरेट किया हुआ कोड जिसे आप सीधे अपने ऐप में पेस्ट कर सकते हैं।
प्लेग्राउंड /docs/playground पर API के लिए एक चैट कंसोल है। आप मॉडल से बात करते हैं, और प्लेग्राउंड वही अनुरोध भेजता है जो आपका कोड भेजता: तीन endpoints में से एक पर, आपके तय किए मॉडल, सिस्टम प्रॉम्प्ट, पैरामीटर और टूल के साथ। हर अनुरोध को कोड के रूप में और रॉ स्ट्रीम इवेंट के रूप में वापस पढ़ा जा सकता है।
शुरुआत
- इसे एक key दें — साइन इन होने पर प्लेग्राउंड आपके अकाउंट की API key इस्तेमाल करता है और आपका बैलेंस दिखाता है। साइन इन न होने पर Add key चुनें और key पेस्ट करें: वह केवल इसी टैब में रहती है और कभी सहेजी नहीं जाती।
- एक endpoint और एक मॉडल चुनें — ऊपर की बार में endpoint स्विच और मॉडल पिकर है। नई बातचीत Chat Completions पर
shannon-3के साथ शुरू होती है। - संदेश भेजें — नीचे टाइप करें और Enter दबाएँ। हर उत्तर बातचीत में जुड़ता है, इसलिए अगला संदेश उसे आगे बढ़ाता है। खाली स्क्रीन तीन शुरुआती प्रॉम्प्ट और एक तैयार टूल-कॉल उदाहरण देती है।
अपनी key आप Keys & usage पेज पर पाते और बदलते हैं। Keys और उपयोग
Endpoints और मॉडल
endpoint स्विच तय करता है कि प्लेग्राउंड कौन सा अनुरोध फ़ॉर्मेट बनाए। आप इसे बातचीत के बीच में बदल सकते हैं; संदेश बने रहते हैं।
| Endpoint | यह कौन सा अनुरोध भेजता है | संदर्भ |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Anthropic फ़ॉर्मेट |
मॉडल पिकर वही सूची दिखाता है जो GET /v1/models लौटाता है। उसमें खोजा जा सकता है, वह आपके हाल के मॉडल ऊपर रखता है, और हर मॉडल के लिए प्रति 1M टोकन की कीमत, कॉन्टेक्स्ट विंडो और टूल, इमेज इनपुट, रीज़निंग और स्ट्रक्चर्ड आउटपुट के चिह्न दिखाता है।
बातचीत
- उत्तर लिखे जाते ही बातचीत में स्ट्रीम होते हैं। मॉडल की रीज़निंग अपने अलग ब्लॉक में दिखती है, जिसे आप समेट सकते हैं।
- हर उत्तर के नीचे: पहले टोकन तक का समय, टोकन प्रति सेकंड, बीता हुआ समय, इनपुट और आउटपुट टोकन कैश्ड और रीज़निंग हिस्सों के साथ, टर्न की लागत का अनुमान, फ़िनिश रीज़न और रिस्पॉन्स id।
- आपका संदेश संपादित किया जा सकता है और उस बिंदु से फिर भेजा जा सकता है। उत्तर दोबारा बनाया जा सकता है। संदेश हटाया जा सकता है, और हटाना कुछ सेकंड तक पूर्ववत किया जा सकता है।
- Stop या Esc कुंजी लिखे जा रहे उत्तर को रोक देती है।
- इमेज इमेज बटन से, पेस्ट करके या फ़ाइल ड्रॉप करके जोड़ी जाती हैं, उन मॉडल के लिए जो इमेज लेते हैं। इमेज भेजने से पहले उसकी लंबी किनारी 1,568 पिक्सेल तक स्केल की जाती है। 30 MB से बड़ी फ़ाइल छोड़ दी जाती है।
- कंपोज़र और सिस्टम प्रॉम्प्ट टोकन गिनती दिखाते हैं। होस्टेड ओपन-वेट मॉडल के लिए यह
POST /v1/tokenizeकी सटीक गिनती है। बाकी मॉडल के लिए यह अनुमान है, जो≈से चिह्नित है। - विफल अनुरोध बताता है कि आगे क्या करें: key अस्वीकार होने पर key सेट करें, बैलेंस खत्म होने पर टॉप-अप करें, बहुत ज़्यादा अनुरोधों के बाद प्रतीक्षा के सेकंड, या सर्वर एरर के बाद दोबारा प्रयास।
अनुरोध सेटिंग
Settings बटन छह टैब वाला पैनल खोलता है। सेटिंग बातचीत की होती हैं: हर बातचीत अपनी सेटिंग रखती है।
| टैब | इसमें क्या होता है |
|---|---|
| सिस्टम | बातचीत का सिस्टम प्रॉम्प्ट, जो हर अनुरोध के साथ भेजा जाता है। पाँच टेम्पलेट इसे भर देते हैं, और इसकी टोकन गिनती दिखाई जाती है। |
| पैरामीटर | अधिकतम आउटपुट टोकन, तापमान, top_p, रीज़निंग एफ़र्ट, स्टॉप सीक्वेंस, seed, और स्ट्रीमिंग और वेब खोज के स्विच। जिस कंट्रोल के लिए चुने गए endpoint में फ़ील्ड नहीं है, वह बंद और चिह्नित रहता है। |
| टूल | अनुरोध के साथ भेजी गई टूल परिभाषाएँ: चार प्रीसेट (get_weather, read_file, run_shell, web_search) या JSON के रूप में आपकी अपनी परिभाषा, और tool_choice (auto, none, required या नाम से एक टूल)। जब मॉडल टूल कॉल करता है, तो बातचीत में वह कॉल परिणाम के लिए एक बॉक्स के साथ दिखती है। Offer sample results चालू होने पर एक क्लिक नमूना परिणाम भर देता है। आप अपना परिणाम भी टाइप कर सकते हैं, फिर उसे भेजकर टर्न आगे बढ़ाएँ। |
| स्ट्रक्चर्ड | response_format: text, json_object या json_schema, स्कीमा नाम और JSON स्कीमा के साथ। स्कीमा सेट होने पर आख़िरी उत्तर उससे मिलाकर जाँचा जाता है और बातचीत में मेल खाने या न खाने के रूप में चिह्नित होता है। Messages endpoint पर यह टैब बंद रहता है, और जो विकल्प चुना गया मॉडल नहीं लेता वह दिखाया नहीं जाता। |
| कोड | मौजूदा बातचीत का अनुरोध cURL, Python, Node या Go कोड के रूप में, बातचीत और उसकी सेटिंग से बना। key YOUR_API_KEY के रूप में छपती है। कोड को कॉपी किया जा सकता है या बड़े व्यू में खोला जा सकता है। |
| इवेंट | आख़िरी टर्न जैसा वह तार पर गया: हर स्ट्रीम इवेंट अपने समय-ऑफ़सेट और एक फ़िल्टर के साथ, जोड़ा हुआ उत्तर, उत्तर के हेडर (x-request-id, content-type, retry-after, date) और अनुरोध की बॉडी। ये पेज रीलोड होने तक रखे जाते हैं। |
इनपुट जाँच
आपके टाइप किए मान अनुरोध भेजने से पहले जाँचे जाते हैं। सीमा से बाहर का मान उसके फ़ील्ड पर चिह्नित किया जाता है, और ठीक होने तक भेजना रोका रहता है।
| सेटिंग | जाँच |
|---|---|
| अधिकतम आउटपुट टोकन | 1 से मॉडल के max_output_tokens तक की पूर्ण संख्या। |
| तापमान | 0 से 2 तक की संख्या। खाली छोड़ने पर फ़ील्ड अनुरोध में नहीं जाता। |
top_p | 0 से 1 तक की संख्या। खाली छोड़ने पर फ़ील्ड अनुरोध में नहीं जाता। |
seed | एक पूर्ण संख्या। |
| स्टॉप सीक्वेंस | अधिकतम 4, अल्पविराम से अलग किए हुए। |
response_format | वह होना चाहिए जिसे चुना गया मॉडल लेता है। जिस बातचीत को json_schema या response_format के बिना मॉडल पर ले जाया गया हो, उसे कारण के साथ रोक दिया जाता है। |
| इमेज | जब आप केवल टेक्स्ट लेने वाले मॉडल पर जाते हैं, तो इमेज संदेश से हटा दी जाती हैं, एक नोट के साथ। |
दो मॉडल की तुलना
More मेनू में Compare two models दूसरा मॉडल पिकर जोड़ता है। तब हर संदेश उन्हीं सेटिंग के साथ एक ही समय पर दोनों मॉडल को जाता है, और दोनों उत्तर आमने-सामने दिखते हैं, A और B चिह्नित। आप एक तरफ़ को अकेले दोबारा बना सकते हैं। जब एक तरफ़ टूल कॉल करती है, तो आपका भेजा परिणाम केवल उसी तरफ़ को आगे बढ़ाता है।
शेयर, एक्सपोर्ट और इम्पोर्ट
- Copy share link बातचीत को लिंक में ही पैक कर देता है,
#के बाद वाले हिस्से में। कुछ अपलोड नहीं होता। इमेज, आपकी key और आख़िरी रन का ब्योरा छोड़ दिया जाता है। जो भी लिंक खोलता है उसे बातचीत अपने प्लेग्राउंड में नई बातचीत के रूप में मिलती है। - लिंक के लिए बहुत लंबी बातचीत को एक नोट के साथ मना कर दिया जाता है। उसे JSON के रूप में डाउनलोड करें।
- Download conversation JSON बातचीत को उसकी सेटिंग के साथ फ़ाइल के रूप में सहेजता है। बातचीत पैनल में Import JSON ऐसी फ़ाइल खोलता है।
- Copy as cURL मौजूदा अनुरोध को एक cURL कमांड के रूप में कॉपी करता है।
क्या कहाँ रखा जाता है
| क्या | कहाँ रखा जाता है |
|---|---|
| बातचीत, सहेजे गए टूल, हाल के मॉडल, पैनल लेआउट | इस ब्राउज़र में। वे Shannon को नहीं भेजे जाते और दूसरे डिवाइस पर आपके साथ नहीं जाते। |
| API key | खुले टैब की मेमोरी में। पेस्ट की गई key पेज रीलोड होने या टैब बंद होने पर चली जाती है। साइन इन होने पर key हर बार आपके अकाउंट से पढ़ी जाती है। |
| आख़िरी टर्न के स्ट्रीम इवेंट, हेडर और अनुरोध | खुले पेज में, रीलोड होने तक। |
| अनुरोध | आपके ब्राउज़र से आपकी key के साथ API को भेजे जाते हैं। वे किसी भी दूसरे API अनुरोध की तरह आपके बैलेंस में गिने जाते हैं। |
कीबोर्ड
| कुंजियाँ | यह क्या करता है |
|---|---|
Enter | संदेश भेजें। |
Shift + Enter | नई पंक्ति शुरू करें। |
Ctrl + K | कमांड पैलेट खोलें: endpoint या मॉडल बदलें, सिस्टम टेम्पलेट चुनें, नई बातचीत शुरू करें, स्ट्रीमिंग, टूल या तुलना चालू-बंद करें। Mac पर: ⌘ K। |
Esc | लिखा जा रहा उत्तर रोकें, या संकरी स्क्रीन पर खुला पैनल बंद करें। |