Ruka hadi kwenye maudhui
Uwanja wa API

Uwanja wa API

Shirikishi

Jaribu kila model na endpoint kwenye kivinjari ukitumia key yako mwenyewe — output ya streaming, kikagua ombi, na code iliyotengenezwa unayoweza kubandika moja kwa moja kwenye programu yako.

Zindua Playground

Playground ni console ya chat kwa API kwenye /docs/playground. Unaongea na model, na playground hutuma maombi yale yale ambayo code yako ingetuma: kwa mojawapo ya endpoint tatu, na model, system prompt, parameters na tools unazoweka. Kila ombi linaweza kusomwa tena kama code na kama stream events ghafi.

Anza

  • Ipe key — Ukiwa umeingia, playground hutumia API key ya akaunti yako na kuonyesha salio lako. Usipoingia, chagua Ongeza key na ubandike key: huhifadhiwa kwenye kichupo hiki pekee na haihifadhiwi kamwe.
  • Chagua endpoint na model — Upau wa juu una swichi ya endpoint na model picker. Mazungumzo mapya huanza kwenye Chat Completions na shannon-3.
  • Tuma ujumbe — Andika chini na ubonyeze Enter. Kila jibu linajiunga na mazungumzo, kwa hiyo ujumbe unaofuata huyaendeleza. Skrini tupu inatoa prompts tatu za kuanzia na mfano tayari wa wito wa tool.

Unapata na kubadilisha key yako kwenye ukurasa wa Keys na matumizi. Keys na matumizi

Endpoint na model

Swichi ya endpoint huamua playground itaunda umbizo gani la ombi. Unaweza kuibadilisha katikati ya mazungumzo; ujumbe hubaki.

Endpoint Ombi inalotuma Marejeo
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic

Model picker inaorodhesha kile GET /v1/models kinarudisha. Inaweza kutafutwa, huweka model zako za hivi karibuni juu, na kwa kila model huonyesha bei kwa tokens 1M, dirisha la muktadha na alama za tools, input ya picha, reasoning na matokeo yaliyopangwa.

Mazungumzo

  • Majibu hutiririka kwenye mazungumzo yanapoandikwa. Reasoning ya model inaonyeshwa kwenye block yake yenyewe unayoweza kuikunja.
  • Chini ya kila jibu: muda hadi token ya kwanza, tokens kwa sekunde, muda uliopita, tokens za input na output pamoja na sehemu za cached na reasoning, makadirio ya gharama ya zamu, sababu ya kumaliza na response id.
  • Ujumbe wako unaweza kuhaririwa na kutumwa tena kutoka hatua hiyo. Jibu linaweza kutengenezwa upya. Ujumbe unaweza kufutwa, na kufuta kunaweza kutenguliwa kwa sekunde chache.
  • Sita au kitufe cha Esc humaliza jibu linaloandikwa.
  • Picha huambatishwa kwa kitufe cha picha, kwa kubandika au kwa kudondosha faili, kwa model zinazokubali picha. Picha hupunguzwa hadi pikseli 1,568 kwenye ukingo wake mrefu kabla ya kutumwa. Faili zaidi ya 30 MB huruka.
  • Composer na system prompt zinaonyesha hesabu ya tokens. Kwa model za open-weight zinazopangishwa ni hesabu kamili kutoka POST /v1/tokenize. Kwa model nyingine ni makadirio, yaliyowekwa alama ≈.
  • Ombi lililoshindwa linaonyesha cha kufanya baadaye: weka key ikiwa key ilikataliwa, ongeza salio likiisha, sekunde za kusubiri baada ya maombi mengi mno, au jaribio jipya baada ya kosa la seva.

Mipangilio ya ombi

Kitufe cha Mipangilio hufungua paneli yenye vichupo sita. Mipangilio ni ya mazungumzo: kila mazungumzo huhifadhi yake.

Kichupo Inashikilia nini
System System prompt ya mazungumzo, inayotumwa na kila ombi. Violezo vitano huijaza, na hesabu yake ya tokens inaonyeshwa.
Parameters Tokens za juu za output, temperature, top_p, reasoning effort, stop sequences, seed, na swichi za streaming na web search. Kidhibiti ambacho endpoint iliyochaguliwa haina field yake huzimwa na kuwekwa alama.
Tools Ufafanuzi wa tools unaotumwa na ombi: presets nne (get_weather, read_file, run_shell, web_search) au ufafanuzi wako mwenyewe kama JSON, na tool_choice (auto, none, required au tool moja kwa jina). Model ikiita tool, mazungumzo yanaonyesha wito pamoja na kisanduku cha matokeo. Ukiwasha Toa matokeo ya mfano, kubofya mara moja kunajaza matokeo ya mfano. Unaweza pia kuandika yako, kisha kuyatuma ili kuendeleza zamu.
Muundo response_format: text, json_object au json_schema pamoja na jina la schema na JSON schema. Schema ikiwekwa, jibu la mwisho hukaguliwa dhidi yake na kuwekwa alama kwenye mazungumzo kama linalolingana au la. Kichupo hiki huzimwa kwenye endpoint ya Messages, na chaguo ambalo model iliyochaguliwa haikubali halitolewi.
Code Ombi la mazungumzo ya sasa kama code ya cURL, Python, Node au Go, iliyojengwa kutoka kwenye mazungumzo na mipangilio yake. Key huchapishwa kama YOUR_API_KEY. Code inaweza kunakiliwa au kufunguliwa kwenye mwonekano mkubwa.
Matukio Zamu ya mwisho kama ilivyopita kwenye waya: kila stream event pamoja na offset yake ya muda na kichujio, jibu lililounganishwa, headers za jibu (x-request-id, content-type, retry-after, date) na mwili wa ombi. Hizi huhifadhiwa hadi ukurasa ujipakie upya.

Ukaguzi wa input

Thamani unazoandika hukaguliwa kabla ombi halijatumwa. Thamani iliyo nje ya masafa huwekwa alama kwenye field yake, na kutuma kunazuiwa hadi irekebishwe.

Mpangilio Ukaguzi
Tokens za juu za output Namba nzima kuanzia 1 hadi max_output_tokens ya model.
Temperature Namba kuanzia 0 hadi 2. Ikiwa tupu, field huachwa nje ya ombi.
top_p Namba kuanzia 0 hadi 1. Ikiwa tupu, field huachwa nje ya ombi.
seed Namba nzima.
Stop sequences Zisizozidi 4, zikitenganishwa kwa koma.
response_format Lazima iwe ile ambayo model iliyochaguliwa inakubali. Mazungumzo yaliyohamishiwa kwa model isiyo na json_schema au isiyo na response_format huzuiwa pamoja na sababu.
Picha Huondolewa kwenye ujumbe unapohamia model inayokubali maandishi pekee, pamoja na dokezo.

Linganisha model mbili

Linganisha model mbili kwenye menyu ya Zaidi huongeza model picker ya pili. Kila ujumbe kisha huenda kwa model zote mbili kwa wakati mmoja, na mipangilio ile ile, na majibu mawili yanasimama kando kwa kando, yakiwekwa alama A na B. Unaweza kutengeneza upya upande mmoja pekee. Upande mmoja ukiita tool, matokeo unayotuma yanaendeleza upande huo pekee.

Kushiriki, kusafirisha na kuingiza

  • Nakili kiungo cha kushiriki hufunga mazungumzo ndani ya kiungo chenyewe, katika sehemu iliyo baada ya #. Hakuna kinachopakiwa. Picha, key yako na maelezo ya run ya mwisho huachwa nje. Anayefungua kiungo hupata mazungumzo kama mapya kwenye playground yake mwenyewe.
  • Mazungumzo marefu mno kwa kiungo hukataliwa kwa dokezo. Yapakue kama JSON badala yake.
  • Pakua JSON ya mazungumzo huhifadhi mazungumzo pamoja na mipangilio yake kama faili. Ingiza JSON kwenye paneli ya mazungumzo hufungua faili kama hilo.
  • Nakili kama cURL hunakili ombi la sasa kama amri moja ya cURL.

Nini kinahifadhiwa wapi

Nini Inahifadhiwa wapi
Mazungumzo, tools zilizohifadhiwa, model za hivi karibuni, mpangilio wa paneli Kwenye kivinjari hiki. Hayatumwi kwa Shannon na hayakufuati kwenye kifaa kingine.
API key Kwenye kumbukumbu ya kichupo kilicho wazi. Key iliyobandikwa hupotea ukurasa unapojipakia upya au kichupo kinapofungwa. Ukiwa umeingia, key husomwa kutoka kwenye akaunti yako kila mara.
Stream events, headers na ombi la zamu ya mwisho Kwenye ukurasa ulio wazi, hadi ujipakie upya.
Maombi Hutumwa kutoka kwenye kivinjari chako hadi API na key yako. Huhesabiwa dhidi ya salio lako kama ombi lingine lolote la API.

Kibodi

Vitufe Inafanya nini
Enter Tuma ujumbe.
Shift + Enter Anza mstari mpya.
Ctrl + K Fungua command palette: badilisha endpoint au model, weka kiolezo cha system, anza mazungumzo mapya, washa au zima streaming, tools au kulinganisha. Kwenye Mac: ⌘ K.
Esc Simamisha jibu linaloandikwa, au funga paneli iliyo wazi kwenye skrini nyembamba.

Zindua Playground