Playground ng API
InteraktiboSubukan ang bawat model at endpoint sa browser gamit ang sarili mong key — streaming output, request inspector, at generated code na maaari mong i-paste diretso sa iyong app.
Ang playground ay isang chat console para sa API sa /docs/playground. Nakikipag-usap ka sa isang model, at ipinapadala ng playground ang parehong mga request na ipapadala ng iyong code: sa isa sa tatlong endpoint, kasama ang model, system prompt, parameter at tools na itinakda mo. Ang bawat request ay maaaring basahin muli bilang code at bilang raw na stream event.
Magsimula
- Bigyan ito ng key — Kapag naka-sign in, ginagamit ng playground ang API key ng iyong account at ipinapakita ang iyong balance. Kapag hindi naka-sign in, piliin ang Magdagdag ng key at i-paste ang isang key: itinatago ito sa tab na ito lamang at hindi kailanman sine-save.
- Pumili ng endpoint at model — Hawak ng itaas na bar ang endpoint switch at ang model picker. Nagsisimula ang bagong conversation sa Chat Completions gamit ang
shannon-3. - Magpadala ng message — Mag-type sa ibaba at pindutin ang Enter. Bawat reply ay bahagi ng conversation, kaya itinutuloy ito ng susunod na message. Nag-aalok ang walang lamang screen ng tatlong panimulang prompt at isang handang halimbawa ng tool call.
Makikita at mai-rotate mo ang iyong key sa pahinang Keys & usage. Keys & usage
Mga endpoint at model
Ang endpoint switch ang nagpapasya kung aling request format ang binubuo ng playground. Maaari mo itong palitan sa gitna ng conversation; nananatili ang mga message.
| Endpoint | Request na ipinapadala nito | Reference |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Anthropic |
Inililista ng model picker ang ibinabalik ng GET /v1/models. Maaari itong hanapan, pinananatili sa itaas ang iyong mga kamakailang model, at ipinapakita para sa bawat model ang presyo kada 1M tokens, ang context window at mga marka para sa tools, image input, reasoning at structured output.
Ang conversation
- Nag-i-stream ang mga reply sa thread habang isinusulat ang mga ito. Ipinapakita ang reasoning ng model sa sarili nitong block na maaari mong tiklupin.
- Sa ilalim ng bawat reply: oras hanggang sa unang token, tokens kada segundo, lumipas na oras, input at output tokens kasama ang cached at reasoning na bahagi, pagtatantya ng halaga ng turn, ang dahilan ng pagtatapos at ang response id.
- Ang message mo ay maaaring i-edit at ipadala muli mula sa puntong iyon. Ang reply ay maaaring i-regenerate. Ang message ay maaaring tanggalin, at maaaring i-undo ang pagtanggal sa loob ng ilang segundo.
- Tinatapos ng Stop o ng Esc key ang reply na isinusulat.
- Ikinakabit ang mga image gamit ang image button, sa pag-paste o sa pag-drop ng file, para sa mga model na tumatanggap ng image. Ang image ay ini-scale sa 1,568 pixel sa mahabang gilid bago ipadala. Nilalaktawan ang file na lampas 30 MB.
- Nagpapakita ng bilang ng token ang composer at ang system prompt. Para sa mga hosted open-weight model, ito ang eksaktong bilang mula sa
POST /v1/tokenize. Para sa ibang model, ito ay pagtatantya, na may markang≈. - Ipinapakita ng nabigong request kung ano ang susunod na gagawin: mag-set ng key kapag tinanggihan ang key, mag-top up kapag naubos ang balance, ang segundong hihintayin pagkatapos ng sobrang daming request, o muling pagsubok pagkatapos ng server error.
Mga setting ng request
Ang button na Mga setting ay nagbubukas ng panel na may anim na tab. Ang mga setting ay pag-aari ng conversation: bawat conversation ay may sarili.
| Tab | Ano ang laman |
|---|---|
| System | Ang system prompt ng conversation, ipinapadala sa bawat request. Limang template ang pumupuno nito, at ipinapakita ang bilang ng token nito. |
| Mga parameter | Max output tokens, temperature, top_p, reasoning effort, mga stop sequence, seed, at ang mga switch para sa streaming at web search. Ang control na walang field sa napiling endpoint ay naka-off at may marka. |
| Tools | Mga tool definition na ipinapadala kasama ng request: apat na preset (get_weather, read_file, run_shell, web_search) o sarili mong definition bilang JSON, at tool_choice (auto, none, required o isang tool ayon sa pangalan). Kapag tumawag ng tool ang model, ipinapakita ng thread ang call na may kahon para sa resulta. Kapag naka-on ang Mag-alok ng sample results, pinupunan ng isang click ang sample na resulta. Maaari ka ring mag-type ng sarili mo, saka ipadala ito para ipagpatuloy ang turn. |
| Structured | response_format: text, json_object o json_schema na may pangalan ng schema at isang JSON schema. Kapag may naka-set na schema, sinusuri ang huling sagot laban dito at minamarkahan sa thread kung tugma o hindi. Naka-off ang tab sa Messages endpoint, at hindi iniaalok ang opsyong hindi tinatanggap ng napiling model. |
| Code | Ang request ng kasalukuyang conversation bilang cURL, Python, Node o Go code, binuo mula sa conversation at mga setting nito. Ipinapakita ang key bilang YOUR_API_KEY. Maaaring kopyahin ang code o buksan sa malaking view. |
| Mga event | Ang huling turn kung paano ito dumaan sa wire: bawat stream event na may time offset nito at filter, ang pinagsama-samang reply, ang mga reply header (x-request-id, content-type, retry-after, date) at ang request body. Itinatago ang mga ito hanggang mag-reload ang pahina. |
Mga pagsusuri sa input
Sinusuri ang mga value na tina-type mo bago ipadala ang request. Ang value na wala sa saklaw ay minamarkahan sa field nito, at pinipigilan ang pagpapadala hanggang maayos ito.
| Setting | Pagsusuri |
|---|---|
| Max output tokens | Isang buong numero mula 1 hanggang sa max_output_tokens ng model. |
| Temperature | Isang numero mula 0 hanggang 2. Kapag walang laman, hindi isinasama ang field sa request. |
top_p | Isang numero mula 0 hanggang 1. Kapag walang laman, hindi isinasama ang field sa request. |
seed | Isang buong numero. |
| Mga stop sequence | Hanggang 4, pinaghihiwalay ng comma. |
response_format | Dapat isa na tinatanggap ng napiling model. Ang conversation na inilipat sa model na walang json_schema o walang response_format ay pinipigilan, kasama ang dahilan. |
| Mga image | Inaalis sa message kapag lumipat ka sa model na text lang ang tinatanggap, na may paalala. |
Ihambing ang dalawang model
Ang Ihambing ang dalawang model sa menu na Higit pa ay nagdaragdag ng pangalawang model picker. Pagkatapos, ang bawat message ay napupunta sa parehong model nang sabay, na may parehong setting, at magkatabi ang dalawang sagot, na may markang A at B. Maaari mong i-regenerate ang isang panig lamang. Kapag tumawag ng tool ang isang panig, ang resultang ipapadala mo ay magpapatuloy sa panig na iyon lamang.
Ibahagi, i-export at i-import
- Ipinapaloob ng I-copy ang share link ang conversation sa mismong link, sa bahagi pagkatapos ng
#. Walang ina-upload. Hindi isinasama ang mga image, ang iyong key at ang mga detalye ng huling takbo. Ang sinumang magbukas ng link ay makakakuha ng conversation bilang bago sa sarili nilang playground. - Ang conversation na masyadong mahaba para sa link ay tinatanggihan na may paalala. I-download ito bilang JSON sa halip.
- Sine-save ng I-download ang conversation JSON ang conversation kasama ang mga setting nito bilang file. Binubuksan ng I-import ang JSON sa panel ng mga conversation ang ganoong file.
- Kinokopya ng I-copy bilang cURL ang kasalukuyang request bilang isang cURL command.
Ano ang itinatago saan
| Ano | Kung saan itinatago |
|---|---|
| Mga conversation, naka-save na tools, kamakailang model, layout ng panel | Sa browser na ito. Hindi ipinapadala ang mga ito sa Shannon at hindi sumusunod sa iyo sa ibang device. |
| API key | Sa memorya ng bukas na tab. Nawawala ang na-paste na key kapag nag-reload ang pahina o nagsara ang tab. Kapag naka-sign in, binabasa ang key mula sa iyong account sa bawat pagkakataon. |
| Mga stream event, header at request ng huling turn | Sa bukas na pahina, hanggang mag-reload ito. |
| Mga request | Ipinapadala mula sa iyong browser papunta sa API gamit ang iyong key. Binibilang ang mga ito laban sa iyong balance tulad ng anumang ibang API request. |
Keyboard
| Mga key | Ano ang ginagawa nito |
|---|---|
Enter | Ipadala ang message. |
Shift + Enter | Magsimula ng bagong linya. |
Ctrl + K | Buksan ang command palette: magpalit ng endpoint o model, mag-set ng system template, magsimula ng bagong conversation, i-toggle ang streaming, tools o compare. Sa Mac: ⌘ K. |
Esc | Ihinto ang reply na isinusulat, o isara ang bukas na panel sa makitid na screen. |