API விளையாட்டு மைதானம்

ஊடாடும்

ஒவ்வொரு மாடலையும் endpoint-ஐயும் உலாவியில் உங்கள் சொந்த key-யுடன் முயற்சிக்கவும் — streaming வெளியீடு, கோரிக்கை ஆய்வி, மற்றும் உங்கள் ஆப்பில் நேரடியாக ஒட்டக்கூடிய உருவாக்கப்பட்ட குறியீடு.

Playground-ஐத் தொடங்கு

playground என்பது /docs/playground-ல் உள்ள API-க்கான அரட்டைக் கன்சோல். நீங்கள் மாடலுடன் பேசுகிறீர்கள், உங்கள் குறியீடு அனுப்பும் அதே கோரிக்கைகளை playground அனுப்புகிறது: நீங்கள் அமைக்கும் மாடல், system prompt, அளவுருக்கள் மற்றும் tools உடன் மூன்று endpoint-களில் ஒன்றுக்கு. ஒவ்வொரு கோரிக்கையையும் குறியீடாகவும் மூல stream நிகழ்வுகளாகவும் திரும்பப் படிக்கலாம்.

தொடக்கம்

ஒரு key-ஐக் கொடுங்கள் — உள்நுழைந்திருந்தால், playground உங்கள் கணக்கின் API key-ஐப் பயன்படுத்தி உங்கள் இருப்பைக் காட்டும். உள்நுழையாவிட்டால், Add key-ஐத் தேர்ந்தெடுத்து key-ஐ ஒட்டுங்கள்: அது இந்தத் தாவலில் மட்டுமே இருக்கும், சேமிக்கப்படாது.
ஒரு endpoint-ஐயும் மாடலையும் தேர்ந்தெடுங்கள் — மேல் பட்டியில் endpoint சுவிட்சும் மாடல் தேர்வியும் உள்ளன. புதிய உரையாடல் Chat Completions-ல் shannon-3 உடன் தொடங்கும்.
ஒரு செய்தியை அனுப்புங்கள் — கீழே தட்டச்சு செய்து Enter-ஐ அழுத்துங்கள். ஒவ்வொரு பதிலும் உரையாடலில் இணையும், எனவே அடுத்த செய்தி அதைத் தொடரும். காலியான திரை மூன்று தொடக்க prompts-ஐயும் தயாரான tool அழைப்பு எடுத்துக்காட்டையும் வழங்கும்.

உங்கள் key-ஐ Keys & usage பக்கத்தில் காணலாம், மாற்றலாம். Keys & usage

Endpoint-களும் மாடல்களும்

எந்தக் கோரிக்கை வடிவத்தை playground உருவாக்கும் என்பதை endpoint சுவிட்ச் தீர்மானிக்கிறது. உரையாடலின் நடுவிலும் அதை மாற்றலாம்; செய்திகள் அப்படியே இருக்கும்.

Endpoint	அது அனுப்பும் கோரிக்கை	குறிப்புரை
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	மானுடவியல் வடிவம்

மாடல் தேர்வி GET /v1/models தருவதைப் பட்டியலிடும். அதில் தேடலாம், உங்கள் சமீபத்திய மாடல்களை மேலே வைத்திருக்கும், ஒவ்வொரு மாடலுக்கும் 1M டோக்கன்களுக்கான விலை, context window மற்றும் tools, பட உள்ளீடு, reasoning மற்றும் கட்டமைக்கப்பட்ட வெளியீட்டுக்கான குறிகளைக் காட்டும்.

உரையாடல்

பதில்கள் எழுதப்படும்போதே உரையாடலில் stream ஆகும். மாடலின் reasoning, நீங்கள் மடிக்கக்கூடிய தனிப் பகுதியில் காட்டப்படும்.
ஒவ்வொரு பதிலின் கீழும்: முதல் டோக்கன் வரையிலான நேரம், வினாடிக்கு டோக்கன்கள், கடந்த நேரம், cache செய்த மற்றும் reasoning பகுதிகளுடன் உள்ளீட்டு மற்றும் வெளியீட்டு டோக்கன்கள், சுற்றின் செலவு மதிப்பீடு, முடிவுக் காரணம் மற்றும் response id.
உங்கள் செய்தியைத் திருத்தி அந்தப் புள்ளியிலிருந்து மீண்டும் அனுப்பலாம். பதிலை மீண்டும் உருவாக்கலாம். செய்தியை நீக்கலாம், நீக்கத்தைச் சில வினாடிகளுக்குச் செயல்தவிர்க்கலாம்.
Stop அல்லது Esc விசை எழுதப்பட்டுக்கொண்டிருக்கும் பதிலை முடிக்கும்.
படங்களை ஏற்கும் மாடல்களுக்கு, பட பொத்தான் மூலமும், ஒட்டுவதன் மூலமும், கோப்பை இழுத்துவிடுவதன் மூலமும் படங்களை இணைக்கலாம். அனுப்பும் முன் படம் அதன் நீளமான பக்கத்தில் 1,568 பிக்சலுக்கு அளவு மாற்றப்படும். 30 MB-க்கு மேற்பட்ட கோப்பு தவிர்க்கப்படும்.
composer-ம் system prompt-ம் டோக்கன் எண்ணிக்கையைக் காட்டும். ஹோஸ்ட் செய்யப்பட்ட open-weight மாடல்களுக்கு அது POST /v1/tokenize தரும் துல்லியமான எண்ணிக்கை. மற்ற மாடல்களுக்கு அது ≈ எனக் குறிக்கப்பட்ட மதிப்பீடு.
தோல்வியடைந்த கோரிக்கை அடுத்து என்ன செய்வது என்பதைக் காட்டும்: key நிராகரிக்கப்பட்டால் key-ஐ அமையுங்கள், இருப்பு தீர்ந்தால் ரீசார்ஜ் செய்யுங்கள், அதிகக் கோரிக்கைகளுக்குப் பிறகு காத்திருக்க வேண்டிய வினாடிகள், அல்லது சர்வர் பிழைக்குப் பிறகு மீண்டும் முயற்சி.

கோரிக்கை அமைப்புகள்

Settings பொத்தான் ஆறு தாவல்கள் கொண்ட பேனலைத் திறக்கும். அமைப்புகள் உரையாடலுக்கு உரியவை: ஒவ்வொரு உரையாடலும் தன் சொந்தத்தை வைத்திருக்கும்.

தாவல்	அது கொண்டிருப்பது
System	உரையாடலின் system prompt, ஒவ்வொரு கோரிக்கையுடனும் அனுப்பப்படும். ஐந்து டெம்ப்ளேட்கள் அதை நிரப்பும், அதன் டோக்கன் எண்ணிக்கை காட்டப்படும்.
அளவுருக்கள்	அதிகபட்ச வெளியீட்டு டோக்கன்கள், temperature, `top_p`, reasoning effort, நிறுத்த வரிசைகள், `seed`, மற்றும் streaming, இணையத் தேடலுக்கான சுவிட்சுகள். தேர்ந்தெடுத்த endpoint-ல் புலம் இல்லாத கட்டுப்பாடு அணைக்கப்பட்டுக் குறிக்கப்படும்.
Tools	கோரிக்கையுடன் அனுப்பப்படும் tool வரையறைகள்: நான்கு முன்னமைவுகள் (`get_weather`, `read_file`, `run_shell`, `web_search`) அல்லது JSON ஆக உங்கள் சொந்த வரையறை, மற்றும் `tool_choice` (`auto`, `none`, `required` அல்லது பெயரால் ஒரு tool). மாடல் ஒரு tool-ஐ அழைக்கும்போது, உரையாடல் அந்த அழைப்பை முடிவுக்கான பெட்டியுடன் காட்டும். Offer sample results இயக்கத்தில் இருந்தால், ஒரே கிளிக் மாதிரி முடிவை நிரப்பும். நீங்களே தட்டச்சும் செய்யலாம், பிறகு சுற்றைத் தொடர அனுப்புங்கள்.
கட்டமைக்கப்பட்டது	`response_format`: `text`, `json_object`, அல்லது schema பெயருடனும் JSON schema-வுடனும் `json_schema`. schema அமைக்கப்பட்டால், கடைசிப் பதில் அதற்கு எதிராகச் சரிபார்க்கப்பட்டு, உரையாடலில் பொருந்துகிறதா இல்லையா எனக் குறிக்கப்படும். Messages endpoint-ல் இந்தத் தாவல் அணைக்கப்படும், தேர்ந்தெடுத்த மாடல் ஏற்காத விருப்பம் வழங்கப்படாது.
குறியீடு	தற்போதைய உரையாடலின் கோரிக்கை, உரையாடலிலிருந்தும் அதன் அமைப்புகளிலிருந்தும் உருவாக்கப்பட்ட cURL, Python, Node அல்லது Go குறியீடாக. key `YOUR_API_KEY` என அச்சிடப்படும். குறியீட்டை நகலெடுக்கலாம் அல்லது பெரிய காட்சியில் திறக்கலாம்.
நிகழ்வுகள்	கடைசிச் சுற்று இணையத்தில் சென்றபடியே: ஒவ்வொரு stream நிகழ்வும் அதன் நேர இடைவெளியுடனும் ஒரு வடிகட்டியுடனும், ஒன்றிணைக்கப்பட்ட பதில், பதில் headers (`x-request-id`, `content-type`, `retry-after`, `date`) மற்றும் கோரிக்கை body. பக்கம் மீண்டும் ஏற்றப்படும் வரை இவை வைக்கப்படும்.

உள்ளீட்டுச் சரிபார்ப்புகள்

நீங்கள் தட்டச்சு செய்யும் மதிப்புகள் கோரிக்கை அனுப்பும் முன் சரிபார்க்கப்படும். வரம்புக்கு வெளியே உள்ள மதிப்பு அதன் புலத்தில் குறிக்கப்படும், அது சரிசெய்யப்படும் வரை அனுப்புவது நிறுத்தி வைக்கப்படும்.

அமைப்பு	சரிபார்ப்பு
அதிகபட்ச வெளியீட்டு டோக்கன்கள்	1 முதல் மாடலின் `max_output_tokens` வரையிலான முழு எண்.
Temperature	0 முதல் 2 வரையிலான எண். காலியாக விட்டால் புலம் கோரிக்கையில் இடம்பெறாது.
`top_p`	0 முதல் 1 வரையிலான எண். காலியாக விட்டால் புலம் கோரிக்கையில் இடம்பெறாது.
`seed`	ஒரு முழு எண்.
நிறுத்த வரிசைகள்	அதிகபட்சம் 4, காற்புள்ளிகளால் பிரிக்கப்பட்டவை.
`response_format`	தேர்ந்தெடுத்த மாடல் ஏற்கும் ஒன்றாக இருக்க வேண்டும். `json_schema` அல்லது `response_format` இல்லாத மாடலுக்கு மாற்றப்பட்ட உரையாடல் காரணத்துடன் நிறுத்தி வைக்கப்படும்.
படங்கள்	உரை மட்டும் ஏற்கும் மாடலுக்கு மாறும்போது, குறிப்புடன் செய்தியிலிருந்து நீக்கப்படும்.

இரண்டு மாடல்களை ஒப்பிடுதல்

More மெனுவில் உள்ள Compare two models இரண்டாவது மாடல் தேர்வியைச் சேர்க்கும். ஒவ்வொரு செய்தியும் பிறகு இரண்டு மாடல்களுக்கும் ஒரே நேரத்தில், அதே அமைப்புகளுடன் செல்லும், இரண்டு பதில்களும் A மற்றும் B எனக் குறிக்கப்பட்டுப் பக்கம் பக்கமாக நிற்கும். ஒரு பக்கத்தை மட்டும் மீண்டும் உருவாக்கலாம். ஒரு பக்கம் tool-ஐ அழைத்தால், நீங்கள் அனுப்பும் முடிவு அந்தப் பக்கத்தை மட்டுமே தொடரச் செய்யும்.

Copy share link உரையாடலை இணைப்புக்குள்ளேயே, #-க்குப் பின் உள்ள பகுதியில் அடைத்துவிடும். எதுவும் பதிவேற்றப்படாது. படங்கள், உங்கள் key மற்றும் கடைசி இயக்கத்தின் விவரங்கள் சேர்க்கப்படாது. இணைப்பைத் திறப்பவர் தன் சொந்த playground-ல் அந்த உரையாடலைப் புதியதாகப் பெறுவார்.
இணைப்புக்கு மிக நீளமான உரையாடல் குறிப்புடன் மறுக்கப்படும். அதற்குப் பதிலாக JSON ஆகப் பதிவிறக்குங்கள்.
Download conversation JSON உரையாடலை அதன் அமைப்புகளுடன் ஒரு கோப்பாகச் சேமிக்கும். உரையாடல் பேனலில் உள்ள Import JSON அத்தகைய கோப்பைத் திறக்கும்.
Copy as cURL தற்போதைய கோரிக்கையை ஒரு cURL கட்டளையாக நகலெடுக்கும்.

எது எங்கே வைக்கப்படுகிறது

என்ன	எங்கே வைக்கப்படுகிறது
உரையாடல்கள், சேமித்த tools, சமீபத்திய மாடல்கள், பேனல் அமைப்பு	இந்த உலாவியில். அவை Shannon-க்கு அனுப்பப்படுவதில்லை, வேறு சாதனத்துக்கும் உங்களைப் பின்தொடராது.
API key	திறந்த தாவலின் நினைவகத்தில். ஒட்டிய key பக்கம் மீண்டும் ஏற்றப்படும்போது அல்லது தாவல் மூடப்படும்போது போய்விடும். உள்நுழைந்திருந்தால், ஒவ்வொரு முறையும் key உங்கள் கணக்கிலிருந்து படிக்கப்படும்.
கடைசிச் சுற்றின் stream நிகழ்வுகள், headers மற்றும் கோரிக்கை	திறந்த பக்கத்தில், அது மீண்டும் ஏற்றப்படும் வரை.
கோரிக்கைகள்	உங்கள் உலாவியிலிருந்து உங்கள் key-யுடன் API-க்கு அனுப்பப்படும். மற்ற API கோரிக்கைகளைப் போலவே அவை உங்கள் இருப்பில் கணக்கிடப்படும்.

விசைப்பலகை

விசைகள்	அது என்ன செய்கிறது
`Enter`	செய்தியை அனுப்பு.
`Shift` + `Enter`	புதிய வரியைத் தொடங்கு.
`Ctrl` + `K`	கட்டளைப் palette-ஐத் திற: endpoint அல்லது மாடலை மாற்று, system டெம்ப்ளேட்டை அமை, புதிய உரையாடலைத் தொடங்கு, streaming, tools அல்லது ஒப்பிடுதலை மாற்று. Mac-ல்: ⌘ K.
`Esc`	எழுதப்பட்டுக்கொண்டிருக்கும் பதிலை நிறுத்து, அல்லது குறுகிய திரையில் திறந்த பேனலை மூடு.