API प्लेग्राउंड

इंटरॲक्टिव्ह

तुमच्या स्वतःच्या कीसह ब्राउझरमध्ये प्रत्येक मॉडेल आणि एंडपॉइंट वापरून पहा — स्ट्रीमिंग आउटपुट, रिक्वेस्ट इन्स्पेक्टर आणि थेट तुमच्या अ‍ॅपमध्ये पेस्ट करता येईल असा जनरेट केलेला कोड.

प्लेग्राउंड सुरू करा

प्लेग्राउंड हे /docs/playground वरील API साठीचे चॅट कन्सोल आहे. तुम्ही मॉडेलशी बोलता, आणि प्लेग्राउंड तुमचा कोड पाठवेल तशाच रिक्वेस्ट्स पाठवते: तीन एंडपॉइंट्सपैकी एकाकडे, तुम्ही सेट केलेले मॉडेल, सिस्टम प्रॉम्प्ट, पॅरामीटर्स आणि टूल्ससह. प्रत्येक रिक्वेस्ट कोड म्हणून आणि रॉ स्ट्रीम इव्हेंट्स म्हणून परत वाचता येते.

सुरुवात

तिला की द्या — साइन इन केलेले असल्यास प्लेग्राउंड तुमच्या अकाउंटची API की वापरते आणि तुमचा बॅलन्स दाखवते. साइन इन नसल्यास की जोडा निवडा आणि की पेस्ट करा: ती फक्त या टॅबमध्ये राहते आणि कधीही सेव्ह केली जात नाही.
एंडपॉइंट आणि मॉडेल निवडा — वरच्या बारमध्ये एंडपॉइंट स्विच आणि मॉडेल पिकर आहेत. नवे संभाषण shannon-3 सह Chat Completions वर सुरू होते.
संदेश पाठवा — खाली टाइप करा आणि Enter दाबा. प्रत्येक उत्तर संभाषणाला जोडले जाते, त्यामुळे पुढचा संदेश ते पुढे चालू ठेवतो. रिकाम्या स्क्रीनवर तीन सुरुवातीचे प्रॉम्प्ट्स आणि तयार टूल-कॉल उदाहरण मिळते.

तुमची की तुम्हाला Keys & usage पानावर सापडते आणि तिथेच बदलता येते. की आणि वापर

एंडपॉइंट्स आणि मॉडेल्स

एंडपॉइंट स्विच प्लेग्राउंड कोणत्या रिक्वेस्ट फॉरमॅटमध्ये रिक्वेस्ट बनवते ते ठरवतो. तुम्ही तो संभाषणाच्या मध्येही बदलू शकता; संदेश तसेच राहतात.

एंडपॉइंट	ते पाठवत असलेली रिक्वेस्ट	संदर्भ
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	Anthropic फॉरमॅट

मॉडेल पिकर GET /v1/models जे देते ते दाखवतो. त्यात शोधता येते, तुमची अलीकडील मॉडेल्स वर ठेवली जातात, आणि प्रत्येक मॉडेलसाठी प्रति 1M टोकन्स किंमत, कॉन्टेक्स्ट विंडो आणि टूल्स, इमेज इनपुट, रीझनिंग व स्ट्रक्चर्ड आउटपुटच्या खुणा दिसतात.

संभाषण

उत्तरे लिहिली जात असताना थ्रेडमध्ये स्ट्रीम होतात. मॉडेलचे रीझनिंग स्वतःच्या ब्लॉकमध्ये दाखवले जाते, जो तुम्ही दुमडू शकता.
प्रत्येक उत्तराखाली: पहिल्या टोकनपर्यंतचा वेळ, प्रति सेकंद टोकन्स, कालावधी, कॅश केलेल्या आणि रीझनिंग भागांसह इनपुट व आउटपुट टोकन्स, टर्नच्या खर्चाचा अंदाज, finish reason आणि response id.
तुमचा संदेश संपादित करून त्या बिंदूपासून पुन्हा पाठवता येतो. उत्तर पुन्हा तयार करता येते. संदेश डिलीट करता येतो, आणि डिलीट काही सेकंद पूर्ववत करता येते.
Stop किंवा Esc की लिहिले जात असलेले उत्तर थांबवते.
इमेज घेणाऱ्या मॉडेल्ससाठी, इमेज बटणाने, पेस्ट करून किंवा फाइल ड्रॉप करून इमेज जोडली जाते. इमेज पाठवण्यापूर्वी तिच्या लांब बाजूवर 1,568 पिक्सेलपर्यंत स्केल केली जाते. 30 MB पेक्षा मोठी फाइल वगळली जाते.
कंपोझर आणि सिस्टम प्रॉम्प्ट टोकन संख्या दाखवतात. होस्ट केलेल्या open-weight मॉडेल्ससाठी ती POST /v1/tokenize कडून मिळालेली अचूक संख्या असते. इतर मॉडेल्ससाठी तो अंदाज असतो, ≈ ने चिन्हांकित.
अयशस्वी रिक्वेस्ट पुढे काय करायचे ते दाखवते: की नाकारली गेली असल्यास की सेट करा, बॅलन्स संपला असल्यास टॉप-अप करा, खूप रिक्वेस्ट्स झाल्यावर थांबायचे सेकंद, किंवा सर्व्हर त्रुटीनंतर पुन्हा प्रयत्न.

रिक्वेस्ट सेटिंग्ज

Settings बटण सहा टॅब असलेले पॅनेल उघडते. सेटिंग्ज संभाषणाशी संबंधित आहेत: प्रत्येक संभाषण स्वतःची सेटिंग्ज ठेवते.

टॅब	त्यात काय असते
सिस्टम	संभाषणाचा सिस्टम प्रॉम्प्ट, प्रत्येक रिक्वेस्टसोबत पाठवला जातो. पाच टेम्पलेट्स तो भरतात, आणि त्याची टोकन संख्या दाखवली जाते.
पॅरामीटर्स	कमाल आउटपुट tokens, टेंपरेचर, `top_p`, रीझनिंग प्रयास, स्टॉप सीक्वेन्स, `seed`, आणि स्ट्रीमिंग व वेब सर्चसाठीचे स्विच. निवडलेल्या एंडपॉइंटला फील्ड नसलेले कंट्रोल बंद करून चिन्हांकित केले जाते.
टूल्स	रिक्वेस्टसोबत पाठवलेल्या टूल व्याख्या: चार प्रीसेट (`get_weather`, `read_file`, `run_shell`, `web_search`) किंवा JSON म्हणून तुमची स्वतःची व्याख्या, आणि `tool_choice` (`auto`, `none`, `required` किंवा नावाने एक टूल). मॉडेल टूल कॉल करते तेव्हा थ्रेड कॉल निकालासाठीच्या बॉक्ससह दाखवतो. Offer sample results चालू असल्यास एका क्लिकने नमुना निकाल भरला जातो. तुम्ही स्वतःचा टाइप करूनही टर्न पुढे नेण्यासाठी पाठवू शकता.
स्ट्रक्चर्ड	`response_format`: `text`, `json_object` किंवा स्कीमा नाव आणि JSON स्कीमासह `json_schema`. स्कीमा सेट असल्यास शेवटचे उत्तर त्याविरुद्ध तपासले जाते आणि थ्रेडमध्ये जुळते की नाही असे चिन्हांकित केले जाते. Messages एंडपॉइंटवर हा टॅब बंद असतो, आणि निवडलेले मॉडेल न घेणारा पर्याय दिला जात नाही.
कोड	सध्याच्या संभाषणाची रिक्वेस्ट cURL, Python, Node किंवा Go कोड म्हणून, संभाषण आणि त्याच्या सेटिंग्जवरून बनवलेली. की `YOUR_API_KEY` म्हणून छापली जाते. कोड कॉपी करता येतो किंवा मोठ्या दृश्यात उघडता येतो.
इव्हेंट्स	शेवटचा टर्न तारेवरून गेला तसा: प्रत्येक स्ट्रीम इव्हेंट त्याच्या वेळ ऑफसेटसह आणि फिल्टरसह, जुळवलेले उत्तर, उत्तराचे हेडर्स (`x-request-id`, `content-type`, `retry-after`, `date`) आणि रिक्वेस्ट बॉडी. हे पान रीलोड होईपर्यंत ठेवले जाते.

इनपुट तपासण्या

तुम्ही टाइप केलेली मूल्ये रिक्वेस्ट पाठवण्यापूर्वी तपासली जातात. श्रेणीबाहेरचे मूल्य त्याच्या फील्डवर चिन्हांकित केले जाते, आणि ते दुरुस्त होईपर्यंत पाठवणे थांबवले जाते.

सेटिंग	तपासणी
कमाल आउटपुट tokens	1 ते मॉडेलच्या `max_output_tokens` पर्यंतची पूर्ण संख्या.
टेंपरेचर	0 ते 2 ही संख्या. रिकामे असल्यास फील्ड रिक्वेस्टमधून वगळले जाते.
`top_p`	0 ते 1 ही संख्या. रिकामे असल्यास फील्ड रिक्वेस्टमधून वगळले जाते.
`seed`	पूर्ण संख्या.
स्टॉप सीक्वेन्स	जास्तीत जास्त 4, स्वल्पविरामाने वेगळे केलेले.
`response_format`	निवडलेले मॉडेल घेते त्यापैकी एक असले पाहिजे. `json_schema` किंवा `response_format` नसलेल्या मॉडेलवर हलवलेले संभाषण कारणासह थांबवले जाते.
इमेज	फक्त मजकूर घेणाऱ्या मॉडेलवर गेल्यावर संदेशातून काढल्या जातात, सूचनेसह.

दोन मॉडेल्सची तुलना करा

More मेनूमधील दोन मॉडेल्सची तुलना करा दुसरा मॉडेल पिकर जोडते. त्यानंतर प्रत्येक संदेश दोन्ही मॉडेल्सकडे एकाच वेळी, सारख्याच सेटिंग्जसह जातो, आणि दोन उत्तरे A आणि B अशी चिन्हांकित होऊन शेजारी शेजारी दिसतात. तुम्ही एक बाजू एकटी पुन्हा तयार करू शकता. एखादी बाजू टूल कॉल करते तेव्हा तुम्ही पाठवलेला निकाल फक्त त्या बाजूला पुढे नेतो.

शेअर लिंक कॉपी करा संभाषण लिंकमध्येच, # नंतरच्या भागात, पॅक करते. काहीही अपलोड होत नाही. इमेज, तुमची की आणि शेवटच्या रनचा तपशील वगळले जातात. लिंक उघडणाऱ्याला संभाषण त्याच्या स्वतःच्या प्लेग्राउंडमध्ये नवे संभाषण म्हणून मिळते.
लिंकसाठी खूप लांब असलेले संभाषण सूचनेसह नाकारले जाते. त्याऐवजी ते JSON म्हणून डाउनलोड करा.
संवाद JSON डाउनलोड करा संभाषण त्याच्या सेटिंग्जसह फाइल म्हणून सेव्ह करते. संभाषण पॅनेलमधील JSON इम्पोर्ट करा अशी फाइल उघडते.
cURL म्हणून कॉपी करा सध्याची रिक्वेस्ट एका cURL कमांडच्या रूपात कॉपी करते.

काय कुठे ठेवले जाते

काय	कुठे ठेवले जाते
संभाषणे, सेव्ह केलेली टूल्स, अलीकडील मॉडेल्स, पॅनेल मांडणी	या ब्राउझरमध्ये. ती Shannon कडे पाठवली जात नाहीत आणि दुसऱ्या डिव्हाइसवर तुमच्यासोबत येत नाहीत.
API की	उघड्या टॅबच्या मेमरीत. पेस्ट केलेली की पान रीलोड झाल्यावर किंवा टॅब बंद झाल्यावर जाते. साइन इन केलेले असल्यास की प्रत्येक वेळी तुमच्या अकाउंटमधून वाचली जाते.
शेवटच्या टर्नचे स्ट्रीम इव्हेंट्स, हेडर्स आणि रिक्वेस्ट	उघड्या पानात, ते रीलोड होईपर्यंत.
रिक्वेस्ट्स	तुमच्या ब्राउझरमधून तुमच्या कीसह API कडे पाठवल्या जातात. इतर कोणत्याही API रिक्वेस्टप्रमाणे त्या तुमच्या बॅलन्सवर मोजल्या जातात.

कीबोर्ड

कीज	ते काय करते
`Enter`	संदेश पाठवा.
`Shift` + `Enter`	नवी ओळ सुरू करा.
`Ctrl` + `K`	कमांड पॅलेट उघडा: एंडपॉइंट किंवा मॉडेल बदला, सिस्टम टेम्पलेट सेट करा, नवे संभाषण सुरू करा, स्ट्रीमिंग, टूल्स किंवा तुलना टॉगल करा. Mac वर: ⌘ K.
`Esc`	लिहिले जात असलेले उत्तर थांबवा, किंवा अरुंद स्क्रीनवर उघडलेले पॅनेल बंद करा.