API Playground

ඉන්ටරැක්ටිව්

ඔබේම යතුරෙන් browser එකේ සෑම model එකක් සහ endpoint එකක්ම උත්සාහ කරන්න — streaming output, request inspector සහ ඔබේ app එකට කෙලින්ම paste කළ හැකි generated code.

Playground ආරම්භ කරන්න

Playground එක /docs/playground හි API එක සඳහා chat console එකකි. ඔබ model එකක් සමඟ කතා කරයි, සහ playground එක ඔබේ code එක යවන ඉල්ලීම්ම යවයි: endpoints තුනෙන් එකකට, ඔබ සකසන model, system prompt, parameters සහ tools සමඟ. සෑම ඉල්ලීමක්ම code ලෙසත් අමු stream events ලෙසත් නැවත කියවිය හැක.

ආරම්භය

එයට key එකක් දෙන්න — Sign in වී ඇති විට, playground එක ඔබේ ගිණුමේ API key එක භාවිතා කර ඔබේ ශේෂය පෙන්වයි. Sign in වී නැති විට, Add key තෝරා key එකක් paste කරන්න: එය තබා ගන්නේ මෙම tab එකේ පමණක් වන අතර කිසිවිටක සුරකින්නේ නැත.
Endpoint එකක් සහ model එකක් තෝරන්න — ඉහළ තීරුවේ endpoint switch එක සහ model picker එක ඇත. නව සංවාදයක් ආරම්භ වන්නේ shannon-3 සමඟ Chat Completions මතය.
පණිවිඩයක් යවන්න — පහළින් ටයිප් කර Enter ඔබන්න. සෑම පිළිතුරක්ම සංවාදයට එකතු වන බැවින් ඊළඟ පණිවිඩය එය දිගටම කරගෙන යයි. හිස් තිරය ආරම්භක prompts තුනක් සහ සූදානම් tool-call උදාහරණයක් ඉදිරිපත් කරයි.

ඔබේ key එක සොයාගැනීම සහ මාරු කිරීම Keys & usage පිටුවේදී කළ හැක. යතුරු සහ භාවිතය

Endpoints සහ models

Endpoint switch එක playground එක සාදන ඉල්ලීම් format එක තීරණය කරයි. ඔබට සංවාදයක් මැදදී එය වෙනස් කළ හැක; පණිවිඩ රැඳී පවතී.

Endpoint	එය යවන ඉල්ලීම	යොමුව
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	Anthropic

Model picker එකේ GET /v1/models ආපසු දෙන දේ ලැයිස්තුගත කර ඇත. එය සෙවිය හැකි අතර, ඔබේ මෑත models ඉහළින් තබා ගනී, සහ සෑම model එකකටම tokens 1Mකට මිල, context window එක සහ tools, රූප ආදානය, තර්කනය හා ව්‍යුහගත output සඳහා සලකුණු පෙන්වයි.

සංවාදය

පිළිතුරු ලියවෙන විටම සංවාදයට stream වේ. Model එකේ තර්කනය නැවිය හැකි වෙනම block එකක පෙන්වයි.
සෑම පිළිතුරකටම යටින්: පළමු token එක තෙක් කාලය, තත්පරයකට tokens, ගතවූ කාලය, cached සහ තර්කන කොටස් සමඟ input සහ output tokens, turn එකේ පිරිවැයේ ඇස්තමේන්තුවක්, finish reason එක සහ response id එක.
ඔබේ පණිවිඩයක් සංස්කරණය කර එම ස්ථානයේ සිට නැවත යැවිය හැක. පිළිතුරක් නැවත ජනනය කළ හැක. පණිවිඩයක් මකා දැමිය හැකි අතර, මකා දැමීම තත්පර කිහිපයක් තුළ අහෝසි කළ හැක.
Stop හෝ Esc යතුර ලියවෙමින් පවතින පිළිතුර අවසන් කරයි.
රූප පිළිගන්නා models සඳහා, රූප බොත්තමෙන්, paste කිරීමෙන් හෝ ගොනුවක් drop කිරීමෙන් රූප අමුණනු ලැබේ. රූපයක් යැවීමට පෙර එහි දිගු දාරය pixels 1,568 දක්වා පරිමාණය කෙරේ. 30 MB ට වැඩි ගොනුවක් මඟ හරිනු ලැබේ.
Composer එක සහ system prompt එක token ගණනක් පෙන්වයි. අපගේ සේවාදායකවල ධාවනය වන open-weight models සඳහා එය POST /v1/tokenize වෙතින් නිවැරදි ගණනයි. අනෙක් models සඳහා එය ≈ ලකුණෙන් සලකුණු කළ ඇස්තමේන්තුවකි.
අසාර්ථක ඉල්ලීමක් ඊළඟට කළ යුතු දේ පෙන්වයි: key එක ප්‍රතික්ෂේප වූ විට key එකක් සකසන්න, ශේෂය අවසන් වූ විට credit එකතු කරන්න, ඉල්ලීම් වැඩි වූ පසු රැඳී සිටිය යුතු තත්පර, නැතහොත් server දෝෂයකින් පසු නැවත උත්සාහ කිරීම.

ඉල්ලීමේ සැකසුම්

Settings බොත්තම tabs හයක් සහිත panel එකක් විවෘත කරයි. සැකසුම් සංවාදයට අයත් වේ: සෑම සංවාදයක්ම තමන්ගේම සැකසුම් තබා ගනී.

Tab එක	එහි ඇති දේ
System	සංවාදයේ system prompt එක, සෑම ඉල්ලීමක්ම සමඟ යවයි. Templates පහක් එය පුරවන අතර, එහි token ගණන පෙන්වයි.
Parameters	උපරිම output tokens, temperature, `top_p`, reasoning effort, stop sequences, `seed`, සහ streaming හා web search සඳහා switches. තෝරාගත් endpoint එකට field එකක් නැති පාලකයක් අක්‍රිය කර සලකුණු කෙරේ.
Tools	ඉල්ලීම සමඟ යවන Tool අර්ථ දැක්වීම්: presets හතරක් (`get_weather`, `read_file`, `run_shell`, `web_search`) හෝ JSON ලෙස ඔබේම අර්ථ දැක්වීමක්, සහ `tool_choice` (`auto`, `none`, `required` හෝ නමින් එක tool එකක්). Model එක tool එකක් call කරන විට, සංවාදයේ ප්‍රතිඵලය සඳහා box එකක් සමඟ call එක පෙන්වයි. Offer sample results ක්‍රියාත්මක කර ඇති විට, එක click එකකින් නියැදි ප්‍රතිඵලයක් පුරවයි. ඔබට ඔබේම එකක් ටයිප් කර turn එක දිගටම කරගෙන යාමට එය යැවීමට ද හැක.
Structured	`response_format`: `text`, `json_object`, නැතහොත් schema නමක් සහ JSON schema එකක් සහිත `json_schema`. Schema එකක් සකසා ඇති විට, අවසාන පිළිතුර එයට එරෙහිව පරීක්ෂා කර සංවාදයේ ගැළපෙනවාද නැද්ද යනුවෙන් සලකුණු කෙරේ. Messages endpoint එකේ මෙම tab එක අක්‍රියයි, සහ තෝරාගත් model එක නොපිළිගන්නා විකල්පයක් ඉදිරිපත් නොකෙරේ.
Code	වත්මන් සංවාදයේ ඉල්ලීම cURL, Python, Node හෝ Go code ලෙස, සංවාදයෙන් සහ එහි සැකසුම්වලින් සාදා ඇත. Key එක `YOUR_API_KEY` ලෙස මුද්‍රණය කෙරේ. Code එක පිටපත් කළ හැකිය, නැතහොත් විශාල දසුනක විවෘත කළ හැකිය.
Events	අවසන් turn එක wire එක හරහා ගිය ආකාරයට: සෑම stream event එකක්ම එහි කාල ඕෆ්සෙට් (time offset) සහ filter එකක් සමඟ, එකලස් කළ පිළිතුර, පිළිතුරු headers (`x-request-id`, `content-type`, `retry-after`, `date`) සහ ඉල්ලීමේ body එක. මේවා පිටුව නැවත පූරණය වන තෙක් තබා ගනී.

Input පරීක්ෂා

ඔබ ටයිප් කරන අගයන් ඉල්ලීමක් යැවීමට පෙර පරීක්ෂා කෙරේ. පරාසයෙන් පිටත අගයක් එහි field එකේ සලකුණු කෙරෙන අතර, එය නිවැරදි කරන තෙක් යැවීම නවත්වා ගනී.

සැකසුම	පරීක්ෂාව
උපරිම output tokens	1 සිට model එකේ `max_output_tokens` දක්වා පූර්ණ සංඛ්‍යාවක්.
Temperature	0 සිට 2 දක්වා අංකයක්. හිස්ව තැබුවහොත් field එක ඉල්ලීමෙන් ඉවත් කෙරේ.
`top_p`	0 සිට 1 දක්වා අංකයක්. හිස්ව තැබුවහොත් field එක ඉල්ලීමෙන් ඉවත් කෙරේ.
`seed`	පූර්ණ සංඛ්‍යාවක්.
Stop sequences	උපරිම 4ක්, කොමා වලින් වෙන් කර.
`response_format`	තෝරාගත් model එක පිළිගන්නා එකක් විය යුතුය. `json_schema` නැති හෝ `response_format` නැති model එකකට මාරු කළ සංවාදයක් හේතුව සමඟ නවත්වා ගනී.
රූප	පෙළ පමණක් පිළිගන්නා model එකකට මාරු වන විට, සටහනක් සමඟ පණිවිඩයෙන් ඉවත් කෙරේ.

Models දෙකක් සංසන්දනය කරන්න

More මෙනුවේ Compare two models දෙවන model picker එකක් එකතු කරයි. එවිට සෑම පණිවිඩයක්ම එකම සැකසුම් සමඟ එකම වේලාවේ models දෙකටම යයි, සහ පිළිතුරු දෙක A සහ B ලෙස සලකුණු කර පැත්තකින් පැත්තට පෙන්වයි. ඔබට එක් පැත්තක් පමණක් නැවත ජනනය කළ හැක. එක් පැත්තක් tool එකක් call කරන විට, ඔබ යවන ප්‍රතිඵලය ඒ පැත්ත පමණක් දිගටම කරගෙන යයි.

Copy share link සංවාදය # ට පසුව ඇති කොටසේ, සබැඳිය තුළම ඇසුරුම් කරයි. කිසිවක් upload නොකෙරේ. රූප, ඔබේ key එක සහ අවසන් ධාවනයේ විස්තර ඉවත් කෙරේ. සබැඳිය විවෘත කරන ඕනෑම කෙනෙකුට සංවාදය තමන්ගේම playground එකේ අලුත් සංවාදයක් ලෙස ලැබේ.
සබැඳියකට වඩා දිගු සංවාදයක් සටහනක් සමඟ ප්‍රතික්ෂේප කෙරේ. ඒ වෙනුවට එය JSON ලෙස බාගත කරන්න.
Download conversation JSON සංවාදය එහි සැකසුම් සමඟ ගොනුවක් ලෙස සුරකියි. සංවාද panel එකේ Import JSON එවැනි ගොනුවක් විවෘත කරයි.
Copy as cURL වත්මන් ඉල්ලීම එක cURL command එකක් ලෙස පිටපත් කරයි.

කුමක් කොතැනද තබා ගන්නේ

කුමක්ද	තබා ගන්නේ කොතැනද
සංවාද, සුරකින ලද tools, මෑත models, panel සැලැස්ම	මෙම browser එකේ. ඒවා Shannon වෙත නොයවන අතර ඔබ සමඟ වෙනත් උපාංගයකට නොපැමිණේ.
API key	විවෘත tab එකේ මතකයේ. Paste කළ key එක පිටුව නැවත පූරණය වූ විට හෝ tab එක වැසූ විට නැති වේ. Sign in වී ඇති විට, key එක සෑම වරම ඔබේ ගිණුමෙන් කියවයි.
අවසන් turn එකේ stream events, headers සහ ඉල්ලීම	විවෘත පිටුවේ, එය නැවත පූරණය වන තෙක්.
ඉල්ලීම්	ඔබේ browser එකෙන් ඔබේ key එක සමඟ API එකට යවයි. වෙනත් ඕනෑම API ඉල්ලීමක් මෙන් ඒවා ඔබේ ශේෂයට ගණන් ගැනේ.

යතුරු පුවරුව

යතුරු	එය කරන දේ
`Enter`	පණිවිඩය යවන්න.
`Shift` + `Enter`	නව පේළියක් ආරම්භ කරන්න.
`Ctrl` + `K`	Command palette එක විවෘත කරන්න: endpoint හෝ model මාරු කරන්න, system template එකක් සකසන්න, නව සංවාදයක් ආරම්භ කරන්න, streaming, tools හෝ compare ක්‍රියාත්මක/අක්‍රිය කරන්න. Mac මත: ⌘ K.
`Esc`	ලියවෙමින් පවතින පිළිතුර නවත්වන්න, නැතහොත් පටු තිරයක විවෘත panel එකක් වසන්න.