Siirry sisältöön
API Playground

API Playground

Interaktiivinen

Kokeile jokaista mallia ja päätepistettä selaimessa omalla avaimellasi — suoratoistettu tuloste, pyyntötarkastelija ja generoitu koodi, jonka voit liittää suoraan sovellukseesi.

Avaa Playground

Playground on API:n chat-konsoli osoitteessa /docs/playground. Keskustelet mallin kanssa, ja playground lähettää samat pyynnöt kuin koodisi lähettäisi: yhteen kolmesta päätepisteestä, asettamallasi mallilla, järjestelmäpromptilla, parametreilla ja työkaluilla. Jokaisen pyynnön voi lukea takaisin koodina ja raakoina striimitapahtumina.

Aloitus

  • Anna sille avain — Kirjautuneena playground käyttää tilisi API-avainta ja näyttää saldosi. Jos et ole kirjautunut, valitse Lisää avain ja liitä avain: se säilytetään vain tässä välilehdessä eikä sitä koskaan tallenneta.
  • Valitse päätepiste ja malli — Yläpalkissa ovat päätepistekytkin ja mallinvalitsin. Uusi keskustelu alkaa Chat Completionsilla ja mallilla shannon-3.
  • Lähetä viesti — Kirjoita alas ja paina Enter. Jokainen vastaus liittyy keskusteluun, joten seuraava viesti jatkaa sitä. Tyhjällä näytöllä on kolme aloitusprompttia ja valmis työkalukutsuesimerkki.

Löydät ja vaihdat avaimesi Keys & usage -sivulta. Avaimet ja käyttö

Päätepisteet ja mallit

Päätepistekytkin päättää, minkä pyyntömuodon playground rakentaa. Voit vaihtaa sitä kesken keskustelun; viestit säilyvät.

Päätepiste Pyyntö, jonka se lähettää Viite
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Antrooppinen muoto

Mallinvalitsin listaa sen, minkä GET /v1/models palauttaa. Siinä voi hakea, se pitää viimeisimmät mallisi ylhäällä ja näyttää jokaisesta mallista hinnan per 1M tokenia, kontekstikoon sekä merkit työkaluille, kuvasyötteelle, päättelylle ja strukturoidulle tulosteelle.

Keskustelu

  • Vastaukset striimautuvat keskusteluun sitä mukaa kuin ne kirjoitetaan. Mallin päättely näytetään omassa lohkossaan, jonka voi kutistaa.
  • Jokaisen vastauksen alla: aika ensimmäiseen tokeniin, tokenia sekunnissa, kulunut aika, syöte- ja tulostetokenit välimuisti- ja päättelyosuuksineen, arvio vuoron kustannuksesta, lopetussyy ja vasteen id.
  • Omaa viestiäsi voi muokata ja lähettää uudelleen siitä kohdasta. Vastauksen voi luoda uudelleen. Viestin voi poistaa, ja poiston voi perua muutaman sekunnin ajan.
  • Lopeta tai Esc-näppäin päättää kirjoitettavana olevan vastauksen.
  • Kuvat liitetään kuvapainikkeella, liittämällä tai pudottamalla tiedosto, malleille, jotka ottavat kuvia. Kuva skaalataan 1,568 pikseliin pitkältä reunaltaan ennen lähetystä. Yli 30 MB:n tiedosto ohitetaan.
  • Viestikenttä ja järjestelmäprompt näyttävät tokenmäärän. Hostatuilla avoimen painon malleilla se on tarkka määrä komennosta POST /v1/tokenize. Muilla malleilla se on arvio, joka merkitään ≈-merkillä.
  • Epäonnistunut pyyntö näyttää, mitä tehdä seuraavaksi: aseta avain, kun avain hylättiin, lisää saldoa, kun saldo on käytetty, odotettavat sekunnit liian monen pyynnön jälkeen tai uusintayritys palvelinvirheen jälkeen.

Pyyntöasetukset

Asetukset-painike avaa paneelin, jossa on kuusi välilehteä. Asetukset kuuluvat keskustelulle: jokaisella keskustelulla on omansa.

Välilehti Mitä se sisältää
Järjestelmä Keskustelun järjestelmäprompt, joka lähetetään jokaisen pyynnön mukana. Viisi mallipohjaa täyttää sen, ja sen tokenmäärä näytetään.
Parametrit Maksimitulostus-tokenit, lämpötila, top_p, päättelyteho, pysäytyssekvenssit, seed sekä striimauksen ja verkkohaun kytkimet. Säädin, jolle valitulla päätepisteellä ei ole kenttää, kytketään pois ja merkitään.
Työkalut Pyynnön mukana lähetettävät työkalumääritykset: neljä esiasetusta (get_weather, read_file, run_shell, web_search) tai oma määrityksesi JSON-muodossa, sekä tool_choice (auto, none, required tai yksi työkalu nimellä). Kun malli kutsuu työkalua, keskustelu näyttää kutsun ja tuloskentän. Kun Tarjoa esimerkkituloksia on päällä, yksi napsautus täyttää esimerkkituloksen. Voit myös kirjoittaa oman ja lähettää sen vuoron jatkamiseksi.
Rakenne response_format: text, json_object tai json_schema skeeman nimellä ja JSON-skeemalla. Kun skeema on asetettu, viimeinen vastaus tarkistetaan sitä vasten ja merkitään keskusteluun vastaavaksi tai ei. Välilehti on pois käytöstä Messages-päätepisteessä, eikä vaihtoehtoa, jota valittu malli ei ota, tarjota.
Koodi Nykyisen keskustelun pyyntö cURL-, Python-, Node- tai Go-koodina, rakennettuna keskustelusta ja sen asetuksista. Avain tulostetaan muodossa YOUR_API_KEY. Koodin voi kopioida tai avata suureen näkymään.
Tapahtumat Viimeinen vuoro sellaisena kuin se kulki langassa: jokainen striimitapahtuma aikasiirtymineen ja suodatin, koottu vastaus, vastauksen otsakkeet (x-request-id, content-type, retry-after, date) ja pyynnön runko. Nämä säilytetään, kunnes sivu ladataan uudelleen.

Syötteen tarkistukset

Kirjoittamasi arvot tarkistetaan ennen pyynnön lähettämistä. Vaihteluvälin ulkopuolinen arvo merkitään kenttäänsä, ja lähetys estetään, kunnes se on korjattu.

Asetus Tarkistus
Maksimitulostus-tokenit Kokonaisluku väliltä 1 – mallin max_output_tokens.
Lämpötila Luku väliltä 0–2. Tyhjä jättää kentän pois pyynnöstä.
top_p Luku väliltä 0–1. Tyhjä jättää kentän pois pyynnöstä.
seed Kokonaisluku.
Pysäytyssekvenssit Enintään 4, pilkulla erotettuina.
response_format Sen on oltava sellainen, jonka valittu malli ottaa. Keskustelu, joka siirretään malliin ilman json_schema-tukea tai ilman response_format-tukea, pysäytetään ja syy kerrotaan.
Kuvat Poistetaan viestistä, kun vaihdat malliin, joka ottaa vain tekstiä, ja siitä kerrotaan huomautuksella.

Vertaa kahta mallia

Vertaa kahta mallia Lisää-valikossa lisää toisen mallinvalitsimen. Jokainen viesti menee silloin molemmille malleille samaan aikaan samoilla asetuksilla, ja kaksi vastausta näkyvät rinnakkain merkittyinä A ja B. Voit luoda vain toisen puolen uudelleen. Kun toinen puoli kutsuu työkalua, lähettämäsi tulos jatkaa vain sitä puolta.

Jaa, vie ja tuo

  • Kopioi jakolinkki pakkaa keskustelun itse linkkiin, #-merkin jälkeiseen osaan. Mitään ei lähetetä palvelimelle. Kuvat, avaimesi ja viimeisen ajon tiedot jätetään pois. Se, joka avaa linkin, saa keskustelun uutena keskusteluna omaan playgroundiinsa.
  • Liian pitkä keskustelu linkiksi hylätään huomautuksella. Lataa se sen sijaan JSON-muodossa.
  • Lataa keskustelu JSON-muodossa tallentaa keskustelun asetuksineen tiedostoksi. Tuo JSON keskustelupaneelissa avaa tällaisen tiedoston.
  • Kopioi cURL-muodossa kopioi nykyisen pyynnön yhtenä cURL-komentona.

Mitä säilytetään missä

Mitä Missä se säilytetään
Keskustelut, tallennetut työkalut, viimeisimmät mallit, paneelin asettelu Tässä selaimessa. Niitä ei lähetetä Shannonille eivätkä ne seuraa sinua toiselle laitteelle.
API-avain Avoimen välilehden muistissa. Liitetty avain katoaa, kun sivu ladataan uudelleen tai välilehti suljetaan. Kirjautuneena avain luetaan tililtäsi joka kerta.
Viimeisen vuoron striimitapahtumat, otsakkeet ja pyyntö Avoimella sivulla, kunnes se ladataan uudelleen.
Pyynnöt Lähetetään selaimestasi API:lle avaimellasi. Ne lasketaan saldoosi kuten mikä tahansa muu API-pyyntö.

Näppäimistö

Näppäimet Mitä se tekee
Enter Lähetä viesti.
Shift + Enter Aloita uusi rivi.
Ctrl + K Avaa komentopaletti: vaihda päätepistettä tai mallia, aseta järjestelmämalli, aloita uusi keskustelu, kytke striimaus, työkalut tai vertailu. Macilla: ⌘ K.
Esc Pysäytä kirjoitettavana oleva vastaus tai sulje avoin paneeli kapealla näytöllä.

Avaa Playground