Ugrás a tartalomra
Playground

Playground

Interaktív

Próbálj ki minden modellt és végpontot a böngészőben a saját kulcsoddal — streaming kimenet, kéréselemző és generált kód, amelyet közvetlenül beilleszthetsz az alkalmazásodba.

Playground indítása

A playground egy chatkonzol az API-hoz a /docs/playground címen. Beszélgetsz egy modellel, a playground pedig ugyanazokat a kéréseket küldi, amelyeket a kódod küldene: a három végpont egyikére, az általad megadott modellel, rendszerpromptal, paraméterekkel és eszközökkel. Minden kérés visszaolvasható kódként és nyers streameseményekként.

Kezdés

  • Adj neki kulcsot — Bejelentkezve a playground a fiókod API-kulcsát használja, és mutatja az egyenlegedet. Bejelentkezés nélkül válaszd az Add key lehetőséget, és illessz be egy kulcsot: csak ebben a fülben marad meg, és soha nem mentődik.
  • Válassz végpontot és modellt — A felső sáv tartalmazza a végpontkapcsolót és a modellválasztót. Az új beszélgetés a Chat Completions végponton indul a shannon-3 modellel.
  • Küldj üzenetet — Írj alulra, és nyomd meg az Entert. Minden válasz a beszélgetés része lesz, így a következő üzenet folytatja azt. Az üres képernyő három kezdő promptot és egy kész eszközhívás-példát kínál.

A kulcsodat a Keys & usage oldalon találod és cseréled. Keys & usage

Végpontok és modellek

A végpontkapcsoló dönti el, melyik kérésformátumot építi a playground. Beszélgetés közben is átállíthatod; az üzenetek megmaradnak.

Végpont A kérés, amelyet küld Referencia
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic formátum

A modellválasztó azt listázza, amit a GET /v1/models visszaad. Kereshető, a legutóbbi modelljeidet felül tartja, és minden modellnél mutatja az 1M tokenre jutó árat, a kontextusablakot, valamint az eszközök, a képbemenet, a gondolkodás (reasoning) és a strukturált kimenet jelzését.

A beszélgetés

  • A válaszok írás közben folyamatosan érkeznek a szálba. A modell gondolkodása (reasoning) külön blokkban látszik, amelyet összecsukhatsz.
  • Minden válasz alatt: idő az első tokenig, token másodpercenként, eltelt idő, bemeneti és kimeneti token a gyorsítványos és a gondolkodási (reasoning) részekkel, a forduló költségének becslése, a befejezés oka és a válaszazonosító.
  • Az üzeneted szerkeszthető, és attól a ponttól újra elküldhető. A válasz újragenerálható. Az üzenet törölhető, és a törlés néhány másodpercig visszavonható.
  • A Stop vagy az Esc billentyű leállítja a most írt választ.
  • A képeket a képgombbal, beillesztéssel vagy fájl ráejtésével csatolhatod, a képeket fogadó modelleknél. A képet küldés előtt a hosszabbik oldalán 1,568 pixelre méretezi. A 30 MB-nál nagyobb fájlt kihagyja.
  • A szerkesztő és a rendszerprompt tokenszámot mutat. A hosztolt nyílt súlyú modelleknél ez a POST /v1/tokenize pontos száma. A többi modellnél becslés, ≈ jellel jelölve.
  • A sikertelen kérés megmutatja, mit tegyél: állíts be kulcsot, ha a kulcsot elutasították, tölts fel, ha az egyenleg elfogyott, a túl sok kérés után várandó másodperceket, vagy ismételd meg a kérést szerverhiba után.

Kérésbeállítások

A Beállítások gomb hat füles panelt nyit meg. A beállítások a beszélgetéshez tartoznak: minden beszélgetés a sajátját őrzi.

Fül Mit tartalmaz
System A beszélgetés rendszerprompt-ja, amely minden kéréssel együtt elmegy. Öt sablon tölti ki, és mutatja a tokenszámát.
Paraméterek Max kimeneti token, temperature, top_p, reasoning effort, leállító sorozatok, seed, valamint a streaming és a webes keresés kapcsolói. Az a vezérlő, amelyhez a kiválasztott végpontnak nincs mezője, ki van kapcsolva és meg van jelölve.
Eszközök A kéréssel küldött eszközdefiníciók: négy előbeállítás (get_weather, read_file, run_shell, web_search) vagy a saját definíciód JSON-ként, valamint a tool_choice (auto, none, required vagy egy eszköz név szerint). Ha a modell eszközt hív, a szál megmutatja a hívást egy mezővel az eredménynek. Bekapcsolt Offer sample results mellett egy kattintás kitölt egy mintaeredményt. Saját eredményt is beírhatsz, majd elküldheted a forduló folytatásához.
Strukturált response_format: text, json_object vagy json_schema sémanévvel és JSON-sémával. Beállított séma esetén az utolsó választ ellenőrzi a séma alapján, és a szálban jelöli, hogy megfelel-e. A fül a Messages végponton ki van kapcsolva, és azt a lehetőséget, amelyet a kiválasztott modell nem fogad el, nem kínálja fel.
Kód Az aktuális beszélgetés kérése cURL, Python, Node vagy Go kódként, a beszélgetésből és beállításaiból felépítve. A kulcs YOUR_API_KEY néven jelenik meg. A kód másolható, vagy nagy nézetben megnyitható.
Események Az utolsó forduló úgy, ahogy a vezetéken ment: minden streameseményt az időeltolásával és szűrővel, az összeállított választ, a válaszfejléceket (x-request-id, content-type, retry-after, date) és a kérés törzsét. Ezek az oldal újratöltéséig megmaradnak.

Bemeneti ellenőrzések

A beírt értékeket a kérés elküldése előtt ellenőrzi. A tartományon kívüli értéket a mezőjénél jelöli, és a küldést visszatartja, amíg ki nem javítod.

Beállítás Ellenőrzés
Max kimeneti token Egész szám 1-től a modell max_output_tokens értékéig.
Hőmérséklet (temperature) Szám 0-tól 2-ig. Ha üres, a mező kimarad a kérésből.
top_p Szám 0-tól 1-ig. Ha üres, a mező kimarad a kérésből.
seed Egész szám.
Leállító sorozatok Legfeljebb 4, vesszővel elválasztva.
response_format A kiválasztott modell által elfogadottnak kell lennie. A json_schema nélküli vagy response_format nélküli modellre áttett beszélgetést az indokkal együtt visszatartja.
Képek Ha csak szöveget fogadó modellre váltasz, eltávolítja az üzenetből, megjegyzéssel.

Két modell összehasonlítása

A Továbbiak menü Compare two models funkciója egy második modellválasztót ad hozzá. Ezután minden üzenet egyszerre megy mindkét modellnek, azonos beállításokkal, és a két válasz egymás mellett áll, A és B jelöléssel. Az egyik oldalt külön is újragenerálhatod. Ha az egyik oldal eszközt hív, az általad küldött eredmény csak azt az oldalt folytatja.

Megosztás, exportálás és importálás

  • A Copy share link magába a linkbe csomagolja a beszélgetést, a # utáni részbe. Semmi nem töltődik fel. A képek, a kulcsod és az utolsó futtatás részletei kimaradnak. Aki megnyitja a linket, a beszélgetést új beszélgetésként kapja meg a saját playgroundjában.
  • A linkhez túl hosszú beszélgetést megjegyzéssel elutasítja. Töltsd le helyette JSON-ként.
  • A Download conversation JSON fájlként menti a beszélgetést a beállításaival. A beszélgetések panel Import JSON funkciója megnyit egy ilyen fájlt.
  • A Copy as cURL az aktuális kérést egyetlen cURL-parancsként másolja.

Mi hol tárolódik

Mi Hol tárolódik
Beszélgetések, mentett eszközök, legutóbbi modellek, panelelrendezés Ebben a böngészőben. Nem kerülnek a Shannonhoz, és nem követnek másik eszközre.
API-kulcs A megnyitott fül memóriájában. A beillesztett kulcs eltűnik, ha az oldal újratöltődik, vagy a fül bezárul. Bejelentkezve a kulcsot minden alkalommal a fiókodból olvassa.
Az utolsó forduló streameseményei, fejlécei és kérése A megnyitott oldalon, az újratöltésig.
Kérések A böngésződből mennek az API-hoz a kulcsoddal. Az egyenlegedből számolódnak, mint bármely más API-kérés.

Billentyűzet

Billentyűk Mit csinál
Enter Az üzenet elküldése.
Shift + Enter Új sor kezdése.
Ctrl + K A parancspaletta megnyitása: végpont vagy modell váltása, rendszersablon beállítása, új beszélgetés indítása, a streaming, az eszközök vagy az összehasonlítás kapcsolása. Macen: ⌘ K.
Esc A most írt válasz leállítása, vagy egy nyitott panel bezárása keskeny képernyőn.

Playground indítása