Fara í efni
API leiksvæði

API leiksvæði

Gagnvirkt

Prófaðu öll líkön og endapunkta í vafranum með þínum eigin lykli — streymt úttak, beiðnaskoðari og útbúinn kóði sem þú getur límt beint inn í forritið þitt.

Opna Playground

Playground er spjallborð fyrir API á /docs/playground. Þú talar við líkan og playground sendir sömu beiðnir og kóðinn þinn myndi senda: á einn af þremur endapunktum, með líkaninu, system prompt, færibreytum og tólum sem þú stillir. Hverja beiðni má lesa aftur sem kóða og sem hráa straumatburði.

Byrja

  • Gefðu því lykil — Þegar þú ert skráð(ur) inn notar playground API-lykil reikningsins þíns og sýnir stöðuna þína. Þegar þú ert ekki skráð(ur) inn skaltu velja Bæta við lykli og líma lykil: hann er geymdur í þessum flipa einum og aldrei vistaður.
  • Veldu endapunkt og líkan — Efsta stikan geymir endapunktarofann og líkanavalið. Nýtt samtal byrjar á Chat Completions með shannon-3.
  • Sendu skilaboð — Sláðu inn texta hér fyrir neðan og ýttu á Enter. Hvert svar bætist við samtalið, svo næstu skilaboð halda því áfram. Tómi skjárinn býður upp á þrjá upphafsprompta og tilbúið dæmi um tólakall.

Þú finnur og endurnýjar lykilinn þinn á síðunni Lyklar og notkun. Lyklar og notkun

Endapunktar og líkön

Endapunktarofinn ákveður hvaða beiðnisnið playground smíðar. Þú getur breytt honum í miðju samtali; skilaboðin haldast.

Endapunktur Beiðnin sem það sendir Uppflettirit
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic

Líkanavalið telur upp það sem GET /v1/models skilar. Hægt er að leita í því, það heldur nýjustu líkönunum þínum efst og sýnir fyrir hvert líkan verð á 1M tákn, samhengisgluggann og merki fyrir tól, myndainntak, rökhugsun og skipulagt úttak.

Samtalið

  • Svör streyma inn í samtalið um leið og þau eru skrifuð. Rökhugsun líkansins er sýnd í sérstakri blokk sem þú getur samanbrotið.
  • Undir hverju svari: tími að fyrsta tákni, tákn á sekúndu, liðinn tími, inntaks- og úttakstákn með hlutum úr skyndiminni og rökhugsun, áætlun á kostnaði lotunnar, lokaástæðan og svarauðkennið.
  • Hægt er að breyta skilaboðum frá þér og senda þau aftur frá þeim stað. Hægt er að endurskapa svar. Hægt er að eyða skilaboðum og afturkalla eyðinguna í nokkrar sekúndur.
  • Stöðva eða Esc-lykillinn endar svar sem er verið að skrifa.
  • Myndir eru festar með myndahnappnum, með því að líma eða með því að sleppa skrá, fyrir líkön sem taka við myndum. Mynd er minnkuð í 1,568 pixla á lengri hliðinni áður en hún er send. Skrá yfir 30 MB er sleppt.
  • Ritillinn og system prompt sýna táknafjölda. Fyrir hýst líkön með opnum þyngdum er það nákvæma talan frá POST /v1/tokenize. Fyrir önnur líkön er það áætlun, merkt með ≈.
  • Misheppnuð beiðni sýnir hvað á að gera næst: stilla lykil þegar lyklinum var hafnað, fylla á þegar staðan er uppurin, sekúndurnar sem á að bíða eftir of margar beiðnir, eða endurtilraun eftir þjónsvillu.

Beiðnistillingar

Hnappurinn Stillingar opnar spjald með sex flipum. Stillingar tilheyra samtalinu: hvert samtal heldur sínum eigin.

Flipi Hvað það geymir
System System prompt samtalsins, sendur með hverri beiðni. Fimm sniðmát fylla hann út og táknafjöldi hans er sýndur.
Færibreytur Hámarks úttakstákn, hitastig, top_p, rökhugsunarátak, stöðvunarrunur, seed og rofarnir fyrir streymi og vefleit. Stjórntæki sem valinn endapunktur hefur engan reit fyrir er slökkt og merkt.
Tól Tólaskilgreiningar sendar með beiðninni: fjórar forstillingar (get_weather, read_file, run_shell, web_search) eða þín eigin skilgreining sem JSON, og tool_choice (auto, none, required eða eitt tól eftir nafni). Þegar líkanið kallar á tól sýnir samtalið kallið með reit fyrir niðurstöðuna. Með Bjóða upp á dæmaniðurstöður virkt fyllir einn smellur út dæmaniðurstöðu. Þú getur líka skrifað þína eigin og sent hana til að halda lotunni áfram.
Skipulagt response_format: text, json_object eða json_schema með skemaheiti og JSON-skema. Þegar skema er stillt er síðasta svarið athugað gegn því og merkt í samtalinu sem samsvarandi eða ekki. Flipinn er óvirkur á Messages-endapunktinum, og valkostur sem valda líkanið tekur ekki við er ekki boðinn.
Kóði Beiðni núverandi samtals sem cURL-, Python-, Node- eða Go-kóði, smíðuð úr samtalinu og stillingum þess. Lykillinn er prentaður sem YOUR_API_KEY. Hægt er að afrita kóðann eða opna hann í stórri sýn.
Atburðir Síðasta lotan eins og hún fór um vírinn: hver straumatburður með tímafráviki sínu og síu, samsetta svarið, svarhausarnir (x-request-id, content-type, retry-after, date) og beiðnameginmálið. Þetta er geymt þar til síðan er endurhlaðin.

Athuganir á inntaki

Gildi sem þú slærð inn eru athuguð áður en beiðni er send. Gildi utan marka er merkt við reitinn sinn og sending er stöðvuð þar til það er lagað.

Stilling Athugun
Hámarks úttakstákn Heil tala frá 1 upp í max_output_tokens líkansins.
Hitastig Tala frá 0 til 2. Tómt gildi sleppir reitnum úr beiðninni.
top_p Tala frá 0 til 1. Tómt gildi sleppir reitnum úr beiðninni.
seed Heil tala.
Stöðvunarrunur Í mesta lagi 4, aðskildar með kommum.
response_format Verður að vera eitt sem valda líkanið tekur við. Samtal sem fært er yfir á líkan án json_schema eða án response_format er haldið aftur af með ástæðunni.
Myndir Fjarlægðar úr skilaboðunum þegar þú skiptir yfir á líkan sem tekur aðeins við texta, með athugasemd.

Bera saman tvö líkön

Bera saman tvö líkön í valmyndinni Meira bætir við öðru líkanavali. Hver skilaboð fara þá til beggja líkananna á sama tíma, með sömu stillingum, og svörin tvö standa hlið við hlið, merkt A og B. Þú getur endurskapað aðra hliðina eina. Þegar önnur hliðin kallar á tól heldur niðurstaðan sem þú sendir áfram aðeins þeirri hlið.

Deila, flytja út og flytja inn

  • Afrita deilitengil pakkar samtalinu inn í tengilinn sjálfan, í hlutann á eftir #. Ekkert er hlaðið upp. Myndir, lykillinn þinn og upplýsingar síðustu keyrslu eru undanskilin. Sá sem opnar tengilinn fær samtalið sem nýtt samtal í sínu eigin playground.
  • Samtali sem er of langt fyrir tengil er hafnað með athugasemd. Sæktu það sem JSON í staðinn.
  • Sækja samtal sem JSON vistar samtalið með stillingum þess sem skrá. Flytja inn JSON í samtalaspjaldinu opnar slíka skrá.
  • Afrita sem cURL afritar núverandi beiðni sem eina cURL-skipun.

Hvað er geymt hvar

Hvað Hvar það er geymt
Samtöl, vistuð tól, nýleg líkön, uppsetning spjalda Í þessum vafra. Þau eru ekki send til Shannon og fylgja þér ekki yfir á annað tæki.
API-lykill Í minni opna flipans. Límdur lykill er horfinn þegar síðan er endurhlaðin eða flipanum lokað. Þegar þú ert skráð(ur) inn er lykillinn lesinn úr reikningnum þínum í hvert sinn.
Straumatburðir, hausar og beiðni síðustu lotu Á opnu síðunni, þar til hún er endurhlaðin.
Beiðnir Sendar úr vafranum þínum til API með lyklinum þínum. Þær eru taldar gegn stöðunni þinni eins og hver önnur API-beiðni.

Lyklaborð

Lyklar Hvað það gerir
Enter Senda skilaboðin.
Shift + Enter Byrja nýja línu.
Ctrl + K Opna skipanaspjaldið: skipta um endapunkt eða líkan, stilla system-sniðmát, hefja nýtt samtal, kveikja eða slökkva á streymi, tólum eða samanburði. Á Mac: ⌘ K.
Esc Stöðva svarið sem er verið að skrifa, eða loka opnu spjaldi á mjóum skjá.

Opna Playground