Aqbeż għall-kontenut
Playground tal-API

Playground tal-API

Interattiv

Ipprova kull mudell u endpoint fil-browser b'ċavetta tiegħek — output bi streaming, spettur tat-talbiet, u kodiċi ġġenerat li tista' tpoġġi direttament fl-app tiegħek.

Ibda l-Playground

Il-playground huwa console tal-chat għall-API fuq /docs/playground. Titkellem ma' mudell, u l-playground jibgħat l-istess talbiet li jibgħat il-kodiċi tiegħek: lil wieħed mit-tliet endpoints, bil-mudell, is-system prompt, il-parametri u t-tools li tissettja. Kull talba tista' terġa' tinqara bħala kodiċi u bħala avvenimenti raw tal-istream.

Bidu

  • Agħtih ċavetta — Meta tkun dħalt, il-playground juża ċ-ċavetta tal-API tal-kont tiegħek u juri l-bilanċ tiegħek. Jekk ma dħaltx, agħżel Add key u pejstja ċavetta: tinżamm f'dan it-tab biss u qatt ma tiġi ssejvjata.
  • Agħżel endpoint u mudell — Il-bar ta' fuq iżomm l-iswiċċ tal-endpoint u s-selettur tal-mudelli. Konversazzjoni ġdida tibda fuq Chat Completions b'shannon-3.
  • Ibgħat messaġġ — Ikteb hawn taħt u agħfas Enter. Kull tweġiba tingħaqad mal-konversazzjoni, għalhekk il-messaġġ li jmiss ikompliha. L-iskrin vojt joffri tliet starter prompts u eżempju lest ta' sejħa ta' tool.

Issib u tibdel iċ-ċavetta tiegħek fil-paġna Keys & usage. Ċwievet u użu

Endpoints u mudelli

L-iswiċċ tal-endpoint jiddeċiedi liema format ta' talba jibni l-playground. Tista' tbiddlu f'nofs konversazzjoni; il-messaġġi jibqgħu.

Endpoint It-talba li jibgħat Referenza
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Format Anthropic

Is-selettur tal-mudelli jelenka dak li jagħti lura GET /v1/models. Jista' jiġi fittex, iżomm il-mudelli reċenti tiegħek fuq nett, u juri għal kull mudell il-prezz għal kull 1M token, it-tieqa tal-kuntest u marki għal tools, input ta' immaġini, raġunament u output strutturat.

Il-konversazzjoni

  • It-tweġibiet jiġu fil-konversazzjoni b'streaming hekk kif jinkitbu. Ir-raġunament tal-mudell jintwera f'blokk tiegħu li tista' tagħlaq.
  • Taħt kull tweġiba: ħin sal-ewwel token, tokens kull sekonda, ħin li għadda, tokens ta' input u output bil-partijiet cached u tar-raġunament, stima tal-ispiża tat-turn, ir-raġuni tat-tmiem u l-id tat-tweġiba.
  • Messaġġ tiegħek jista' jiġi editjat u mibgħut mill-ġdid minn dak il-punt. Tweġiba tista' tiġi rrigenerata. Messaġġ jista' jitħassar, u t-tħassir jista' jiġi mħassar għal ftit sekondi.
  • Stop jew iċ-ċavetta Esc jtemmu tweġiba li qed tinkiteb.
  • L-immaġini jiġu mehmuża bil-buttuna tal-immaġni, bil-paste jew bit-tqegħid ta' fajl, għal mudelli li jaċċettaw immaġini. Immaġni tiġi skalata għal 1,568 pixel fuq it-tarf twil tagħha qabel tintbagħat. Fajl ta' aktar minn 30 MB jitħalla barra.
  • Il-composer u s-system prompt juru għadd ta' tokens. Għall-mudelli open-weight ospitati huwa l-għadd eżatt minn POST /v1/tokenize. Għall-mudelli l-oħra huwa stima, immarkata b'≈.
  • Talba li tfalli turi x'għandek tagħmel wara: issettja ċavetta meta ċ-ċavetta tiġi miċħuda, żid kreditu meta l-bilanċ jintuża, is-sekondi biex tistenna wara wisq talbiet, jew tentattiv ġdid wara żball tas-server.

Settings tat-talba

Il-buttuna Settings tiftaħ pannell b'sitt tabs. Is-settings jagħmlu parti mill-konversazzjoni: kull konversazzjoni żżomm tagħha.

Tab X'fih
System Is-system prompt tal-konversazzjoni, mibgħut ma' kull talba. Ħames templates jimlewh, u jintwera l-għadd ta' tokens tiegħu.
Parametri Max output tokens, temperatura, top_p, reasoning effort, stop sequences, seed, u l-iswiċċijiet għall-streaming u t-tiftix fuq il-web. Kontroll li l-endpoint magħżul ma għandux qasam għalih jintefa u jiġi mmarkat.
Tools Definizzjonijiet ta' tools mibgħuta mat-talba: erba' presets (get_weather, read_file, run_shell, web_search) jew id-definizzjoni tiegħek stess bħala JSON, u tool_choice (auto, none, required jew tool wieħed skont l-isem). Meta l-mudell isejjaħ tool, il-konversazzjoni turi s-sejħa b'kaxxa għar-riżultat. B'Offer sample results mixgħul, klikk wieħed jimla riżultat ta' kampjun. Tista' wkoll tikteb tiegħek, imbagħad tibgħatu biex tkompli t-turn.
Strutturat response_format: text, json_object jew json_schema b'isem ta' schema u JSON schema. B'schema ssettjata, l-aħħar tweġiba tiġi ċċekkjata kontra tagħha u mmarkata fil-konversazzjoni bħala li taqbel jew le. It-tab jintefa fuq l-endpoint Messages, u għażla li l-mudell magħżul ma jaċċettax ma tiġix offruta.
Kodiċi It-talba tal-konversazzjoni kurrenti bħala kodiċi cURL, Python, Node jew Go, mibni mill-konversazzjoni u mis-settings tagħha. Iċ-ċavetta tinkiteb YOUR_API_KEY. Il-kodiċi jista' jiġi kkupjat jew miftuħ f'veduta kbira.
Avvenimenti L-aħħar turn kif għadda mill-wire: kull avveniment tal-istream bl-offset tal-ħin tiegħu u filtru, it-tweġiba assemblata, il-headers tat-tweġiba (x-request-id, content-type, retry-after, date) u l-body tat-talba. Dawn jinżammu sakemm terġa' tinbeda l-paġna.

Kontrolli tal-input

Il-valuri li tikteb jiġu ċċekkjati qabel ma tintbagħat talba. Valur barra l-medda jiġi mmarkat fil-qasam tiegħu, u l-ibgħat jinżamm lura sakemm jissewwa.

Setting Kontroll
Max output tokens Numru sħiħ minn 1 sa max_output_tokens tal-mudell.
Temperatura Numru minn 0 sa 2. Vojt iħalli l-qasam barra mit-talba.
top_p Numru minn 0 sa 1. Vojt iħalli l-qasam barra mit-talba.
seed Numru sħiħ.
Stop sequences Massimu ta' 4, separati b'virgola.
response_format Irid ikun wieħed li jaċċetta l-mudell magħżul. Konversazzjoni mċaqalqa għal mudell mingħajr json_schema jew mingħajr response_format tinżamm lura bir-raġuni.
Immaġini Jitneħħew mill-messaġġ meta taqleb għal mudell li jaċċetta test biss, b'nota.

Qabbel żewġ mudelli

Compare two models fil-menu More iżid selettur tat-tieni mudell. Kull messaġġ imbagħad imur għaż-żewġ mudelli fl-istess ħin, bl-istess settings, u ż-żewġ tweġibiet joqogħdu ħdejn xulxin, immarkati A u B. Tista' tirrigenera naħa waħda biss. Meta naħa waħda ssejjaħ tool, ir-riżultat li tibgħat ikompli dik in-naħa biss.

Aqsam, esporta u importa

  • Copy share link jippakkja l-konversazzjoni fil-link innifsu, fil-parti wara #. Ma jittella' xejn. L-immaġini, iċ-ċavetta tiegħek u d-dettalji tal-aħħar run jitħallew barra. Min jiftaħ il-link jieħu l-konversazzjoni bħala waħda ġdida fil-playground tiegħu stess.
  • Konversazzjoni twila wisq għal link tiġi miċħuda b'nota. Niżżilha bħala JSON minflok.
  • Download conversation JSON isalva l-konversazzjoni bis-settings tagħha bħala fajl. Import JSON fil-pannell tal-konversazzjonijiet jiftaħ fajl bħal dan.
  • Copy as cURL jikkopja t-talba kurrenti bħala kmand cURL wieħed.

X'jinżamm fejn

X'inhu Fejn jinżamm
Konversazzjonijiet, tools salvati, mudelli reċenti, layout tal-pannelli F'dan il-browser. Ma jintbagħtux lil Shannon u ma jsegwukx fuq apparat ieħor.
Ċavetta tal-API Fil-memorja tat-tab miftuħ. Ċavetta mpastjata tintilef meta terġa' tinbeda l-paġna jew jingħalaq it-tab. Meta tkun dħalt, iċ-ċavetta tinqara mill-kont tiegħek kull darba.
Avvenimenti tal-istream, headers u talba tal-aħħar turn Fil-paġna miftuħa, sakemm terġa' tinbeda.
Talbiet Jintbagħtu mill-browser tiegħek lill-API biċ-ċavetta tiegħek. Jingħaddu mal-bilanċ tiegħek bħal kull talba oħra tal-API.

Tastiera

Tasti X'jagħmel
Enter Ibgħat il-messaġġ.
Shift + Enter Ibda linja ġdida.
Ctrl + K Iftaħ il-command palette: biddel l-endpoint jew il-mudell, issettja template tas-system, ibda konversazzjoni ġdida, ixgħel jew intefi streaming, tools jew compare. Fuq Mac: ⌘ K.
Esc Waqqaf it-tweġiba li qed tinkiteb, jew agħlaq pannell miftuħ fuq skrin dejjaq.

Ibda l-Playground