API Playground

Whakawhitiwhiti

Whakamātauria ia model me ia endpoint i te pūtirotiro mā tō ake key — output e stream ana, kaitirotiro tono, me te code i hangaia e taea te whakapiri tonu ki tō taupānga.

Whakarewa i te Playground

Ko te playground he papatohu chat mō te API i te /docs/playground. Ka kōrero koe ki tētahi model, ā, ka tuku te playground i ngā tono ōrite ka tukuna e tō waehere: ki tētahi o ngā endpoint e toru, me te model, system prompt, ngā tawhā me ngā tool ka tautuhia e koe. Ka taea te pānui anō i ia tono hei waehere, hei kaupapa stream mata hoki.

Tīmata

Hoatu he key — Ina takiuru koe, ka whakamahi te playground i te API key o tō pūkete, ā, ka whakaatu i tō toenga. Ina kāore koe i te takiuru, kōwhiria Add key ka whakapiri i tētahi key: ka purihia ki tēnei ripa anake, ā, kāore e tiakina.
Kōwhiria tētahi endpoint me tētahi model — Kei te pae o runga te pana endpoint me te kaitīpako model. Ka tīmata tētahi kōrero hou ki Chat Completions me te shannon-3.
Tukuna he karere — Tuhia ki raro, ā, pēhia a Enter. Ka uru ia whakautu ki te kōrero, nō reira ka haere tonu te karere e whai ake nei. Ka tuku te mata kau i ngā prompt tīmata e toru me tētahi tauira karanga tool kua rite.

Ka kitea, ka hurihia hoki tō key i te whārangi Keys & usage. Keys & usage

Ngā endpoint me ngā model

Ka whakatau te pana endpoint i te hōputu tono ka hanga e te playground. Ka taea e koe te huri i waenganui i tētahi kōrero; ka noho tonu ngā karere.

Endpoint	Te tono e tukuna ana	Tohutoro
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	Anthropic

Ka rārangi te kaitīpako model i ngā mea e whakahokia ana e te GET /v1/models. Ka taea te rapu, ka pupuri i ō model tata ki runga, ā, ka whakaatu mō ia model i te utu mō ia 1M token, te matapihi horopaki me ngā tohu mō ngā tool, input whakaahua, reasoning me te output whakaritea.

Te kōrero

Ka stream ngā whakautu ki te kōrero i a rātou e tuhia ana. Ka whakaatuhia te reasoning a te model i tētahi poraka motuhake ka taea te kopi.
I raro i ia whakautu: te wā ki te token tuatahi, ngā token ia hēkona, te wā kua pahemo, ngā token input me output me ngā wāhanga cached me reasoning, he whakatau o te utu o te hurihanga, te take mutunga me te id whakautu.
Ka taea te whakatika me te tuku anō i tētahi karere nāu mai i taua wāhi. Ka taea te hanga anō i tētahi whakautu. Ka taea te mukua tētahi karere, ā, ka taea te whakakore i te muku mō ētahi hēkona.
Ka whakamutu te Stop me te pātuhi Esc i tētahi whakautu e tuhia ana.
Ka tāpirihia ngā whakaahua mā te pātene whakaahua, mā te whakapiri, mā te maturuturu rānei i tētahi kōnae, mō ngā model e whakaae ana ki ngā whakaahua. Ka whakamahuki tētahi whakaahua ki te 1,568 pika i tōna taha roa i mua i te tuku. Ka waihohia tētahi kōnae neke atu i te 30 MB.
Ka whakaatu te kaitito me te system prompt i tētahi tatau token. Mō ngā model open-weight hosted ko te tatau tika mai i te POST /v1/tokenize. Mō ngā model kē atu he whakatau, kua tohua ki te ≈.
Ka whakaatu tētahi tono kua rahua i te mea hei mahi i muri mai: tautuhi i tētahi key ina whakakāhoretia te key, tāpiri nama ina pau te toenga, ngā hēkona hei tatari i muri i te maha rawa o ngā tono, te whakamātau anō rānei i muri i tētahi hapa tūmau.

Ngā tautuhinga tono

Ka huaki te pātene Settings i tētahi paewhiri me ngā ripa e ono. No te kōrero ngā tautuhinga: pupuri ai ia kōrero i tōna ake.

Ripa	Te mea e pupuri ana
System	Te system prompt o te kōrero, ka tukuna i ia tono. E rima ngā tauira hei whakakī i a ia, ā, ka whakaatuhia tana tatau token.
Ngā tawhā	Ngā token output nui rawa, temperature, `top_p`, reasoning effort, ngā raupapa mutu, `seed`, me ngā pana mō te streaming me te rapu tukutuku. Ka whakakorehia, ka tohua hoki tētahi mana kāore he āpure i te endpoint kua kōwhiria.
Ngā tool	Ngā whakamārama tool ka tukuna me te tono: e whā ngā tautuhinga tūpou (`get_weather`, `read_file`, `run_shell`, `web_search`) tō ake whakamārama rānei hei JSON, me te `tool_choice` (`auto`, `none`, `required` tētahi tool rānei mā tōna ingoa). Ina karanga te model i tētahi tool, ka whakaatu te kōrero i te karanga me tētahi pouaka mō te hua. Ina whakakāhia te Offer sample results, ka whakakī tētahi pāwhiri i tētahi hua tauira. Ka taea hoki e koe te tāpae i tō ake, kātahi ka tuku hei haere tonu i te hurihanga.
Whakaritea	`response_format`: `text`, `json_object` `json_schema` rānei me tētahi ingoa schema me tētahi JSON schema. Ina tautuhia tētahi schema, ka tirohia te whakautu whakamutunga ki a ia, ā, ka tohua i te kōrero e hāngai ana, kāore rānei. Ka whakakorehia te ripa i runga i te endpoint Messages, ā, kāore e tukuna tētahi kōwhiringa kāore e whakaaetia e te model kua kōwhiria.
Waehere	Te tono o te kōrero o nāianei hei waehere cURL, Python, Node, Go rānei, kua hangaia mai i te kōrero me ōna tautuhinga. Ka tāngia te key hei `YOUR_API_KEY`. Ka taea te tārua i te waehere, te huaki rānei i roto i tētahi tirohanga nui.
Ngā kaupapa	Te hurihanga whakamutunga i tana haere i te waea: ia kaupapa stream me tōna wā mai te tīmatanga me tētahi tātari, te whakautu kua whakahiatotia, ngā header whakautu (`x-request-id`, `content-type`, `retry-after`, `date`) me te tinana tono. Ka purihia ēnei tae noa ki te utanga anō o te whārangi.

Ngā tirohanga input

Ka tirohia ngā uara ka tāpaetia e koe i mua i te tuku i tētahi tono. Ka tohua tētahi uara i waho i te whānuitanga i tōna āpure, ā, ka puritia te tuku tae noa ki te whakatikatika.

Tautuhinga	Tirohanga
Ngā token output nui rawa	He tau tauoti mai i te 1 ki te `max_output_tokens` o te model.
Temperature	He tau mai i te 0 ki te 2. Ina kau, ka waiho te āpure i te tono.
`top_p`	He tau mai i te 0 ki te 1. Ina kau, ka waiho te āpure i te tono.
`seed`	He tau tauoti.
Ngā raupapa mutu	Tae atu ki te 4, kua wehea ki ngā koma.
`response_format`	Me tētahi e whakaae ana te model kua kōwhiria. Ka puritia tētahi kōrero kua nekehia ki tētahi model kāore he `json_schema` kāore he `response_format` rānei, me te take.
Ngā whakaahua	Ka tangohia i te karere ina huri koe ki tētahi model e whakaae ana ki te kuputuhi anake, me tētahi tuhipoka.

Whakatauritea ngā model e rua

Ka tāpiri te Compare two models i roto i te tahua More i tētahi kaitīpako model tuarua. Ka haere ia karere ki ngā model e rua i te wā kotahi, me ngā tautuhinga ōrite, ā, ka tū ngā whakautu e rua i te taha o tētahi, kua tohua A me B. Ka taea e koe te hanga anō i tētahi taha anake. Ina karanga tētahi taha i tētahi tool, ka haere tonu te hua ka tukuna e koe ki taua taha anake.

Ka takai te Copy share link i te kōrero ki roto i te hononga ake, i te wāhanga i muri i te #. Kāore he mea e tukuna ake. Ka waihohia ngā whakaahua, tō key me ngā taipitopito o te rere whakamutunga. Ka whiwhi te tangata e huaki ana i te hononga i te kōrero hei kōrero hou i tōna ake playground.
Ka whakakāhoretia tētahi kōrero roa rawa mō tētahi hononga me tētahi tuhipoka. Tikiake hei JSON.
Ka tiaki te Download conversation JSON i te kōrero me ōna tautuhinga hei kōnae. Ka huaki te Import JSON i te paewhiri kōrero i taua kōnae.
Ka tārua te Copy as cURL i te tono o nāianei hei tohutohu cURL kotahi.

Te mea e purihia ana ki hea

Te aha	Te wāhi e purihia ai
Ngā kōrero, ngā tool kua tiakina, ngā model tata, te whakatakotoranga paewhiri	I tēnei browser. Kāore e tukuna ki a Shannon, ā, kāore e whai i a koe ki tētahi atu pūrere.
API key	I te mahara o te ripa tuwhera. Ka ngaro tētahi key kua whakapiria ina utaina anō te whārangi, ina katia rānei te ripa. Ina takiuru koe, ka pānuitia te key mai i tō pūkete i ia wā.
Ngā kaupapa stream, ngā header me te tono o te hurihanga whakamutunga	I te whārangi tuwhera, tae noa ki tana utanga anō.
Ngā tono	Ka tukuna mai i tō browser ki te API me tō key. Ka tatauria ki tō toenga pērā i tētahi atu tono API.

Papapātuhi

Ngā pātuhi	Te mahi
`Enter`	Tukuna te karere.
`Shift` + `Enter`	Tīmata i tētahi rārangi hou.
`Ctrl` + `K`	Huaki i te command palette: huri endpoint, model rānei, tautuhi i tētahi tauira system, tīmata i tētahi kōrero hou, whakakā/whakaweto i te streaming, ngā tool, te whakatauritenga rānei. I runga i te Mac: ⌘ K.
`Esc`	Whakamutua te whakautu e tuhia ana, katia rānei tētahi paewhiri tuwhera i runga i tētahi mata kuiti.