API Playground

အပြန်အလှန်

သင့်ကိုယ်ပိုင် key ဖြင့် model နှင့် endpoint တိုင်းကို browser တွင် စမ်းသပ်ပါ — streaming output၊ request inspector နှင့် သင့် app ထဲသို့ တိုက်ရိုက်ကူးထည့်နိုင်သော generate လုပ်ထားသည့် code။

Playground ဖွင့်ရန်

playground သည် /docs/playground ရှိ API အတွက် chat console တစ်ခု ဖြစ်သည်။ သင်သည် model တစ်ခုနှင့် စကားပြောပြီး playground သည် သင့် code ပို့မည့် request များအတိုင်း endpoint သုံးခုအနက် တစ်ခုသို့ သင်သတ်မှတ်သော model၊ system prompt၊ parameters နှင့် tools တို့ဖြင့် ပို့သည်။ request တိုင်းကို code အဖြစ်နှင့် raw stream events အဖြစ် ပြန်ဖတ်နိုင်သည်။

စတင်ရန်

Key တစ်ခု ပေးပါ — Sign in ဝင်ထားလျှင် playground သည် သင့် account ၏ API key ကို သုံးပြီး သင့်လက်ကျန်ငွေကို ပြသည်။ Sign in မဝင်ထားလျှင် Add key ကို ရွေးပြီး key တစ်ခု paste လုပ်ပါ- ၎င်းကို ဤ tab တွင်သာ ထိန်းထားပြီး မည်သည့်အခါမျှ မသိမ်းပါ။
Endpoint နှင့် model တစ်ခု ရွေးပါ — အပေါ်ဆုံးဘားတွင် endpoint ခလုတ်နှင့် model ရွေးချယ်ကိရိယာ ပါသည်။ စကားပြောဆိုမှုအသစ်သည် Chat Completions နှင့် shannon-3 ဖြင့် စတင်သည်။
Message တစ်ခု ပို့ပါ — အောက်တွင် ရိုက်ပြီး Enter နှိပ်ပါ။ ပြန်ကြားချက်တိုင်းသည် စကားပြောဆိုမှုနှင့် ပေါင်းစပ်သဖြင့် နောက် message သည် ဆက်လက်ဖြစ်သွားသည်။ အလွတ် screen တွင် စတင်ရန် prompt သုံးခုနှင့် အသင့်ပြင်ထားသော tool-call နမူနာတစ်ခု ပါသည်။

သင့် key ကို Keys & usage စာမျက်နှာတွင် ရှာဖွေပြီး လဲလှယ်နိုင်သည်။ Keys & usage

Endpoints နှင့် models

endpoint ခလုတ်သည် playground က တည်ဆောက်မည့် request format ကို ဆုံးဖြတ်သည်။ စကားပြောဆိုမှုအလယ်တွင် ပြောင်းနိုင်ပြီး message များ ကျန်ရှိသည်။

Endpoint	ပို့သော request	ကိုးကားချက်
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	Anthropic

model ရွေးချယ်ကိရိယာသည် GET /v1/models ပြန်ပေးသည့်အရာများကို စာရင်းပြသည်။ ရှာဖွေနိုင်ပြီး သင်လတ်တလောသုံးသော model များကို ထိပ်တွင်ထားကာ model တစ်ခုစီအတွက် tokens 1M လျှင် ဈေးနှုန်း၊ context window နှင့် tools၊ ပုံ input၊ reasoning နှင့် structured output အမှတ်အသားများကို ပြသည်။

စကားပြောဆိုမှု

ပြန်ကြားချက်များကို ရေးနေစဉ် thread ထဲသို့ stream လုပ်သည်။ model ၏ reasoning ကို ကိုယ်ပိုင် block တစ်ခုတွင် ပြသပြီး ခေါက်သိမ်းနိုင်သည်။
ပြန်ကြားချက်တစ်ခုစီအောက်တွင်- ပထမ token အထိ အချိန်၊ တစ်စက္ကန့်လျှင် tokens၊ ကုန်ဆုံးချိန်၊ cache နှင့် reasoning အပိုင်းများပါသော input နှင့် output tokens၊ turn ၏ ကုန်ကျစရိတ် ခန့်မှန်းချက်၊ finish reason နှင့် response id။
သင့် message ကို ပြင်ဆင်ပြီး ထိုနေရာမှ ပြန်ပို့နိုင်သည်။ ပြန်ကြားချက်ကို ပြန်လည်ထုတ်လုပ်နိုင်သည်။ message ကို ဖျက်နိုင်ပြီး ဖျက်ခြင်းကို စက္ကန့်အနည်းငယ်အတွင်း ပြန်ဖျက်သိမ်းနိုင်သည်။
Stop သို့မဟုတ် Esc ခလုတ်သည် ရေးနေဆဲ ပြန်ကြားချက်ကို အဆုံးသတ်သည်။
ပုံလက်ခံသော model များအတွက် ပုံများကို ပုံခလုတ်ဖြင့်၊ paste လုပ်ခြင်းဖြင့် သို့မဟုတ် ဖိုင်ကို ချခြင်းဖြင့် တွဲထည့်သည်။ ပုံကို မပို့မီ ရှည်သောအနား 1,568 pixel သို့ ချုံ့သည်။ 30 MB ထက်ကြီးသောဖိုင်ကို ကျော်သွားသည်။
composer နှင့် system prompt တို့တွင် token အရေအတွက်ကို ပြသည်။ Host လုပ်ထားသော open-weight models များအတွက် ၎င်းသည် POST /v1/tokenize မှ တိကျသော အရေအတွက်ဖြစ်သည်။ အခြား model များအတွက် ခန့်မှန်းချက်ဖြစ်ပြီး ≈ ဖြင့် အမှတ်အသားပြုသည်။
မအောင်မြင်သော request သည် နောက်ထပ်လုပ်ရမည့်အရာကို ပြသည်- key ကို ပယ်ချလျှင် key သတ်မှတ်ပါ၊ လက်ကျန်ငွေကုန်လျှင် ဖြည့်ပါ၊ request များလွန်းလျှင် စောင့်ရမည့် စက္ကန့်၊ သို့မဟုတ် server အမှားပြီးနောက် ပြန်ကြိုးစားပါ။

Request settings

Settings ခလုတ်သည် tab ခြောက်ခုပါသော panel တစ်ခုကို ဖွင့်သည်။ Settings များသည် စကားပြောဆိုမှုနှင့် သက်ဆိုင်သည်- စကားပြောဆိုမှုတစ်ခုစီတွင် ကိုယ်ပိုင်ရှိသည်။

Tab	ကိုင်ထားသည့်အရာ
System	request တိုင်းနှင့်အတူ ပို့သော စကားပြောဆိုမှု၏ system prompt။ template ငါးခုက ၎င်းကို ဖြည့်ပေးပြီး ၎င်း၏ token အရေအတွက်ကို ပြသည်။
Parameters	ထုတ်ပေးမည့် token အများဆုံးအရေအတွက်၊ temperature၊ `top_p`၊ reasoning effort၊ stop sequences၊ `seed` နှင့် streaming နှင့် web search အတွက် ခလုတ်များ။ ရွေးထားသော endpoint တွင် field မရှိသော control ကို ပိတ်ထားပြီး အမှတ်အသားပြုထားသည်။
Tools	request နှင့်အတူ ပို့သော tool အဓိပ္ပာယ်ဖွင့်ဆိုချက်များ- preset လေးခု (`get_weather`, `read_file`, `run_shell`, `web_search`) သို့မဟုတ် JSON အဖြစ် သင့်ကိုယ်ပိုင် အဓိပ္ပာယ်ဖွင့်ဆိုချက်နှင့် `tool_choice` (`auto`, `none`, `required` သို့မဟုတ် အမည်ဖြင့် tool တစ်ခု)။ model က tool ကို ခေါ်သောအခါ thread တွင် ရလဒ်အတွက် အကွက်ပါသော call ကို ပြသည်။ Offer sample results ဖွင့်ထားလျှင် တစ်ချက်နှိပ်ရုံဖြင့် နမူနာရလဒ်တစ်ခု ဖြည့်ပေးသည်။ ကိုယ်တိုင်လည်း ရိုက်ထည့်ပြီး turn ကို ဆက်ရန် ပို့နိုင်သည်။
Structured	`response_format`- `text`၊ `json_object` သို့မဟုတ် schema အမည်နှင့် JSON schema ပါသော `json_schema`။ schema သတ်မှတ်ထားလျှင် နောက်ဆုံးအဖြေကို ၎င်းနှင့် တိုက်စစ်ပြီး thread တွင် ကိုက်ညီ/မကိုက်ညီ အမှတ်အသားပြုသည်။ Messages endpoint တွင် tab ကို ပိတ်ထားပြီး ရွေးထားသော model က မလက်ခံသည့် option ကို မပေးပါ။
Code	လက်ရှိစကားပြောဆိုမှု၏ request ကို စကားပြောဆိုမှုနှင့် ၎င်း၏ settings မှ တည်ဆောက်ထားသော cURL၊ Python၊ Node သို့မဟုတ် Go code အဖြစ်။ key ကို `YOUR_API_KEY` အဖြစ် ပုံနှိပ်ထားသည်။ code ကို ကူးယူနိုင်သည် သို့မဟုတ် မြင်ကွင်းကြီးတွင် ဖွင့်နိုင်သည်။
Events	နောက်ဆုံး turn ကို ကြိုးထဲတွင် သွားခဲ့သည့်အတိုင်း- stream event တိုင်းကို ၎င်း၏ အချိန်ကွာခြားမှုနှင့် filter တစ်ခုဖြင့်၊ ပေါင်းစပ်ထားသော ပြန်ကြားချက်၊ ပြန်ကြားချက် headers (`x-request-id`, `content-type`, `retry-after`, `date`) နှင့် request body။ ၎င်းတို့ကို စာမျက်နှာ ပြန်လည် load မလုပ်မချင်း ထိန်းထားသည်။

Input စစ်ဆေးမှုများ

သင်ရိုက်ထည့်သော တန်ဖိုးများကို request မပို့မီ စစ်ဆေးသည်။ အပိုင်းအခြားပြင်ပရှိ တန်ဖိုးကို ၎င်း၏ field တွင် အမှတ်အသားပြုထားပြီး ပြင်ဆင်သည်အထိ ပို့ခြင်းကို ထိန်းထားသည်။

Setting	စစ်ဆေးချက်
Max output tokens	1 မှ model ၏ `max_output_tokens` အထိ ကိန်းပြည့်တစ်ခု။
Temperature	0 မှ 2 အထိ ဂဏန်းတစ်ခု။ အလွတ်ထားလျှင် field ကို request မှ ချန်လှပ်သည်။
`top_p`	0 မှ 1 အထိ ဂဏန်းတစ်ခု။ အလွတ်ထားလျှင် field ကို request မှ ချန်လှပ်သည်။
`seed`	ကိန်းပြည့်တစ်ခု။
Stop sequences	အများဆုံး 4 ခု၊ comma ဖြင့် ခြားထားသည်။
`response_format`	ရွေးထားသော model က လက်ခံသည့်တစ်ခု ဖြစ်ရမည်။ `json_schema` မပါသော သို့မဟုတ် `response_format` မပါသော model သို့ ရွှေ့ထားသည့် စကားပြောဆိုမှုကို အကြောင်းရင်းပြပြီး ထိန်းထားသည်။
ပုံများ	စာသားသာ လက်ခံသော model သို့ ပြောင်းလျှင် မှတ်ချက်တစ်ခုနှင့်အတူ message မှ ဖယ်ရှားသည်။

Model နှစ်ခုကို နှိုင်းယှဉ်ခြင်း

More မီနူးရှိ Model နှစ်ခုကို နှိုင်းယှဉ်ပါ သည် ဒုတိယ model ရွေးချယ်ကိရိယာကို ထည့်ပေးသည်။ ထို့နောက် message တိုင်းကို တူညီသော settings ဖြင့် model နှစ်ခုလုံးသို့ တစ်ပြိုင်နက် ပို့ပြီး အဖြေနှစ်ခုကို A နှင့် B အမှတ်အသားဖြင့် ဘေးချင်းကပ်ပြသည်။ တစ်ဖက်ကိုသာ ပြန်လည်ထုတ်လုပ်နိုင်သည်။ တစ်ဖက်က tool ခေါ်လျှင် သင်ပို့သော ရလဒ်သည် ထိုဖက်ကိုသာ ဆက်လက်သွားသည်။

Share link ကို copy ပြုလုပ်ပါ သည် စကားပြောဆိုမှုကို link ၏ # နောက်ပိုင်းတွင် link ထဲသို့ပင် ထုပ်ပိုးသည်။ ဘာမျှ upload မလုပ်ပါ။ ပုံများ၊ သင့် key နှင့် နောက်ဆုံး run ၏ အသေးစိတ်ကို ချန်လှပ်ထားသည်။ link ကိုဖွင့်သူသည် စကားပြောဆိုမှုကို ၎င်း၏ ကိုယ်ပိုင် playground တွင် အသစ်တစ်ခုအဖြစ် ရရှိသည်။
link အတွက် ရှည်လွန်းသော စကားပြောဆိုမှုကို မှတ်ချက်တစ်ခုနှင့်အတူ ငြင်းပယ်သည်။ ၎င်းအစား JSON အဖြစ် download ပြုလုပ်ပါ။
Conversation JSON ကို download ပြုလုပ်ပါ သည် စကားပြောဆိုမှုကို ၎င်း၏ settings နှင့်အတူ ဖိုင်အဖြစ် သိမ်းသည်။ စကားပြောဆိုမှု panel ရှိ JSON import ပြုလုပ်ပါ သည် ထိုဖိုင်ကို ဖွင့်သည်။
cURL အဖြစ် ကူးယူပါ သည် လက်ရှိ request ကို cURL command တစ်ခုအဖြစ် ကူးယူသည်။

ဘာကို ဘယ်မှာ သိမ်းသည်

အရာ	သိမ်းထားရာ
စကားပြောဆိုမှုများ၊ သိမ်းထားသော tools၊ လတ်တလော models၊ panel အပြင်အဆင်	ဤ browser တွင်။ Shannon သို့ မပို့ဘဲ အခြားစက်သို့ လိုက်မလာပါ။
API key	ဖွင့်ထားသော tab ၏ memory တွင်။ paste လုပ်ထားသော key သည် စာမျက်နှာကို ပြန်လည် load လုပ်လျှင် သို့မဟုတ် tab ပိတ်လျှင် ပျောက်သွားသည်။ Sign in ဝင်ထားလျှင် key ကို အကြိမ်တိုင်း သင့် account မှ ဖတ်သည်။
နောက်ဆုံး turn ၏ stream ဖြစ်ရပ်များ၊ header များနှင့် request ကို သိမ်းထားသည်	ဖွင့်ထားသော စာမျက်နှာတွင်၊ ပြန်လည် load မလုပ်မချင်း။
Requests	သင့် browser မှ သင့် key ဖြင့် API သို့ ပို့သည်။ အခြား API request များကဲ့သို့ သင့်လက်ကျန်ငွေတွင် ရေတွက်သည်။

ကီးဘုတ်

ခလုတ်များ	လုပ်ဆောင်ချက်
`Enter`	message ကို ပို့သည်။
`Shift` + `Enter`	စာကြောင်းအသစ် စတင်သည်။
`Ctrl` + `K`	command palette ကို ဖွင့်သည်- endpoint သို့မဟုတ် model ပြောင်းရန်၊ system template သတ်မှတ်ရန်၊ စကားပြောဆိုမှုအသစ် စတင်ရန်၊ streaming၊ tools သို့မဟုတ် compare ကို ဖွင့်ပိတ်ရန်။ Mac တွင်- ⌘ K။
`Esc`	ရေးနေဆဲ ပြန်ကြားချက်ကို ရပ်သည်၊ သို့မဟုတ် ကျဉ်းသော screen တွင် ဖွင့်ထားသော panel ကို ပိတ်သည်။