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 टोकन मूल्य, कन्टेक्स्ट विन्डो र टुल, छवि इनपुट, रिजनिङ र स्ट्रक्चर्ड आउटपुटका चिनो देखाउँछ।

कुराकानी

जवाफहरू लेखिँदै जाँदा थ्रेडमा स्ट्रिम हुन्छन्। मोडलको रिजनिङ आफ्नै ब्लकमा देखाइन्छ जसलाई तपाईं पट्ट्याउन सक्नुहुन्छ।
हरेक जवाफमुनि: पहिलो टोकनसम्मको समय, प्रति सेकेन्ड टोकन, बितेको समय, क्याश्ड र रिजनिङ भागसहित इनपुट र आउटपुट टोकन, टर्नको लागतको अनुमान, समाप्ति कारण र रेस्पोन्स id।
तपाईंको सन्देश सम्पादन गरेर त्यही बिन्दुबाट फेरि पठाउन सकिन्छ। जवाफ पुन: उत्पन्न गर्न सकिन्छ। सन्देश मेट्न सकिन्छ, र मेटाइ केही सेकेन्डसम्म फिर्ता गर्न सकिन्छ।
रोक्नुहोस् वा Esc कुञ्जीले लेखिँदै गरेको जवाफ रोक्छ।
छवि लिने मोडलहरूका लागि छविहरू छवि बटन, पेस्ट वा फाइल ड्रप गरेर संलग्न गरिन्छन्। छवि पठाउनु अघि यसको लामो छेउ 1,568 पिक्सेलमा सानो बनाइन्छ। 30 MB भन्दा ठूलो फाइल छोडिन्छ।
कम्पोजर र सिस्टम प्रम्प्टले टोकन संख्या देखाउँछन्। होस्ट गरिएका ओपन-वेट मोडलहरूका लागि यो POST /v1/tokenize बाट आएको ठ्याक्कै संख्या हो। अन्य मोडलहरूका लागि यो अनुमान हो, ≈ ले चिनो लगाइएको।
असफल अनुरोधले अर्को के गर्ने भनेर देखाउँछ: की अस्वीकृत हुँदा की सेट गर्ने, ब्यालेन्स सकिँदा टप-अप गर्ने, धेरै अनुरोधपछि पर्खनुपर्ने सेकेन्ड, वा सर्भर त्रुटिपछि फेरि प्रयास।

अनुरोध सेटिङहरू

सेटिङ बटनले छ ट्याब भएको प्यानल खोल्छ। सेटिङहरू कुराकानीका हुन्: हरेक कुराकानीले आफ्नै राख्छ।

ट्याब	यसमा के हुन्छ
सिस्टम	कुराकानीको सिस्टम प्रम्प्ट, हरेक अनुरोधसँग पठाइन्छ। पाँच टेम्प्लेटले यसलाई भर्छन्, र यसको टोकन संख्या देखाइन्छ।
पारामीटर्स	अधिकतम आउटपुट टोकन, तापक्रम, `top_p`, रिजनिङ प्रयास, स्टप सिक्वेन्स, `seed`, र स्ट्रिमिङ र वेब खोजका स्विचहरू। छानिएको इन्डपोइन्टमा फिल्ड नभएको नियन्त्रण बन्द गरिन्छ र चिनो लगाइन्छ।
टुलहरू	अनुरोधसँग पठाइने टुल परिभाषाहरू: चार प्रिसेट (`get_weather`, `read_file`, `run_shell`, `web_search`) वा JSON का रूपमा तपाईंको आफ्नै परिभाषा, र `tool_choice` (`auto`, `none`, `required` वा नामले एउटा टुल)। मोडलले टुल कल गर्दा थ्रेडले नतिजाका लागि बाकससहित कल देखाउँछ। नमूना नतिजा प्रस्ताव गर्नुहोस् खुला हुँदा एक क्लिकले नमूना नतिजा भर्छ। तपाईं आफ्नै पनि टाइप गर्न सक्नुहुन्छ, त्यसपछि टर्न जारी राख्न पठाउनुहोस्।
संरचित	`response_format`: `text`, `json_object` वा स्कीमा नाम र JSON स्कीमासहित `json_schema`। स्कीमा सेट गरिएको बेला अन्तिम जवाफ त्यसविरुद्ध जाँचिन्छ र थ्रेडमा मेल खाएको वा नखाएको चिनो लगाइन्छ। Messages इन्डपोइन्टमा यो ट्याब बन्द हुन्छ, र छानिएको मोडलले नलिने विकल्प देखाइँदैन।
कोड	हालको कुराकानीको अनुरोध cURL, Python, Node वा Go कोडका रूपमा, कुराकानी र यसका सेटिङबाट बनाइएको। की `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 मेनुको दुई मोडल तुलना गर्नुहोस् ले दोस्रो मोडल पिकर थप्छ। त्यसपछि हरेक सन्देश उही सेटिङसहित एकै समयमा दुवै मोडलमा जान्छ, र दुई जवाफ A र B चिनोसहित छेउछेउमा रहन्छन्। तपाईं एक पक्ष मात्र पुन: उत्पन्न गर्न सक्नुहुन्छ। एक पक्षले टुल कल गर्दा तपाईंले पठाउने नतिजाले त्यही पक्षलाई मात्र अघि बढाउँछ।

शेयर लिङ्क कपी गर्नुहोस् ले कुराकानीलाई लिङ्कभित्रै, # पछिको भागमा, प्याक गर्छ। केही अपलोड गरिँदैन। छविहरू, तपाईंको की र पछिल्लो रनका विवरण छुट्छन्। लिङ्क खोल्ने जोसुकैले आफ्नै प्लेग्राउन्डमा कुराकानी नयाँ कुराकानीका रूपमा पाउँछ।
लिङ्कका लागि धेरै लामो कुराकानी टिप्पणीसहित अस्वीकार गरिन्छ। यसको सट्टा JSON का रूपमा डाउनलोड गर्नुहोस्।
कुराकानी JSON डाउनलोड गर्नुहोस् ले कुराकानीलाई सेटिङसहित फाइलका रूपमा सेभ गर्छ। कुराकानी प्यानलमा JSON इम्पोर्ट गर्नुहोस् ले त्यस्तो फाइल खोल्छ।
cURL को रूपमा कपी गर्नुहोस् ले हालको अनुरोधलाई एउटा cURL कमान्डका रूपमा कपी गर्छ।

के कहाँ राखिन्छ

के	कहाँ राखिन्छ
कुराकानी, सेभ गरिएका टुल, हालका मोडल, प्यानल लेआउट	यही ब्राउजरमा। तिनीहरू Shannon मा पठाइँदैनन् र अर्को डिभाइसमा तपाईंसँगै जाँदैनन्।
API की	खुला ट्याबको मेमोरीमा। पेस्ट गरिएको की पेज रिलोड हुँदा वा ट्याब बन्द हुँदा हराउँछ। साइन इन गरेको अवस्थामा की हरेक पटक तपाईंको खाताबाट पढिन्छ।
अन्तिम टर्नका स्ट्रिम इभेन्ट, हेडर र अनुरोध	खुला पेजमा, रिलोड नहुँदासम्म।
अनुरोधहरू	तपाईंको ब्राउजरबाट तपाईंको कीसहित API मा पठाइन्छन्। अरू API अनुरोधजस्तै यिनीहरू तपाईंको ब्यालेन्समा गनिन्छन्।

किबोर्ड

कुञ्जीहरू	यसले के गर्छ
`Enter`	सन्देश पठाउने।
`Shift` + `Enter`	नयाँ लाइन सुरु गर्ने।
`Ctrl` + `K`	कमान्ड प्यालेट खोल्ने: इन्डपोइन्ट वा मोडल बदल्ने, सिस्टम टेम्प्लेट सेट गर्ने, नयाँ कुराकानी सुरु गर्ने, स्ट्रिमिङ, टुल वा तुलना स्विच गर्ने। Mac मा: ⌘ K।
`Esc`	लेखिँदै गरेको जवाफ रोक्ने, वा साँघुरो स्क्रिनमा खुला प्यानल बन्द गर्ने।