Playground
InteraktivníVyzkoušejte každý model a endpoint v prohlížeči se svým vlastním klíčem — streamovaný výstup, inspektor požadavků a vygenerovaný kód, který můžete vložit přímo do své aplikace.
Playground je chatová konzole pro API na /docs/playground. Povídáte si s modelem a playground posílá stejné požadavky, jaké by poslal váš kód: na jeden ze tří endpointů, s modelem, systémovým promptem, parametry a nástroji, které nastavíte. Každý požadavek si lze přečíst zpět jako kód i jako surové události streamu.
Začínáme
- Dejte mu klíč — Po přihlášení playground používá klíč API vašeho účtu a ukazuje váš zůstatek. Bez přihlášení zvolte Přidat klíč a vložte klíč: uchovává se jen v této kartě a nikdy se neukládá.
- Vyberte endpoint a model — Horní lišta obsahuje přepínač endpointu a výběr modelu. Nová konverzace začíná na Chat Completions s
shannon-3. - Odešlete zprávu — Napište níže a stiskněte Enter. Každá odpověď se připojí ke konverzaci, takže další zpráva v ní pokračuje. Prázdná obrazovka nabízí tři úvodní prompty a hotový příklad volání nástroje.
Svůj klíč najdete a vyměníte na stránce Klíče a využití. Klíče a využití
Endpointy a modely
Přepínač endpointu určuje, jaký formát požadavku playground sestaví. Můžete jej změnit uprostřed konverzace; zprávy zůstanou.
| Endpoint | Požadavek, který odešle | Reference |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Formát Anthropic |
Výběr modelu vypisuje to, co vrací GET /v1/models. Lze v něm hledat, vaše nedávné modely drží nahoře a u každého modelu ukazuje cenu za 1M tokenů, kontextové okno a značky pro nástroje, obrazový vstup, uvažování a strukturovaný výstup.
Konverzace
- Odpovědi proudí do vlákna, jak se píší. Uvažování modelu se zobrazuje ve vlastním bloku, který lze sbalit.
- Pod každou odpovědí: doba do prvního tokenu, tokeny za sekundu, uplynulý čas, vstupní a výstupní tokeny s cachovanou částí a částí uvažování, odhad ceny kola, důvod ukončení a id odpovědi.
- Vaši zprávu lze upravit a odeslat znovu od tohoto místa. Odpověď lze vygenerovat znovu. Zprávu lze smazat a smazání lze několik sekund vrátit zpět.
- Zastavit nebo klávesa Esc ukončí odpověď, která se právě píše.
- Obrázky se přikládají tlačítkem obrázku, vložením ze schránky nebo přetažením souboru, u modelů, které obrázky přijímají. Obrázek se před odesláním zmenší na 1,568 pixelů na delší straně. Soubor nad 30 MB se přeskočí.
- Pole pro psaní a systémový prompt ukazují počet tokenů. U hostovaných modelů s otevřenými váhami je to přesný počet z
POST /v1/tokenize. U ostatních modelů je to odhad, označený≈. - Neúspěšný požadavek ukáže, co dělat dál: nastavit klíč, když byl klíč odmítnut, dobít, když je zůstatek vyčerpán, počet sekund čekání po příliš mnoha požadavcích, nebo zkusit znovu po chybě serveru.
Nastavení požadavku
Tlačítko Nastavení otevře panel se šesti kartami. Nastavení patří ke konverzaci: každá konverzace si uchovává své vlastní.
| Karta | Co obsahuje |
|---|---|
| Systém | Systémový prompt konverzace, odesílaný s každým požadavkem. Vyplní jej pět šablon a zobrazí se jeho počet tokenů. |
| Parametry | Maximální výstupní tokeny, teplota, top_p, úsilí o uvažování, stop sekvence, seed a přepínače streamování a vyhledávání na webu. Ovládací prvek, pro který zvolený endpoint nemá pole, je vypnutý a označený. |
| Nástroje | Definice nástrojů odesílané s požadavkem: čtyři předvolby (get_weather, read_file, run_shell, web_search) nebo vaše vlastní definice jako JSON a tool_choice (auto, none, required nebo jeden nástroj podle názvu). Když model volá nástroj, vlákno ukáže volání s polem pro výsledek. Se zapnutou volbou Nabízet ukázkové výsledky vyplní ukázkový výsledek jedno kliknutí. Můžete také napsat vlastní a poslat jej, aby kolo pokračovalo. |
| Strukturované | response_format: text, json_object nebo json_schema s názvem schématu a schématem JSON. Při nastaveném schématu se poslední odpověď proti němu zkontroluje a ve vlákně se označí, zda odpovídá, nebo ne. Karta je na endpointu Messages vypnutá a volba, kterou zvolený model nepřijímá, se nenabízí. |
| Kód | Požadavek aktuální konverzace jako kód v cURL, Pythonu, Node nebo Go, sestavený z konverzace a jejího nastavení. Klíč se vypíše jako YOUR_API_KEY. Kód lze zkopírovat nebo otevřít ve velkém zobrazení. |
| Události | Poslední kolo tak, jak šlo po drátě: každá událost streamu s časovým odstupem a filtrem, složená odpověď, hlavičky odpovědi (x-request-id, content-type, retry-after, date) a tělo požadavku. Uchovávají se, dokud se stránka znovu nenačte. |
Kontroly vstupu
Hodnoty, které zadáte, se před odesláním požadavku zkontrolují. Hodnota mimo rozsah se označí u svého pole a odeslání se zadrží, dokud ji neopravíte.
| Nastavení | Kontrola |
|---|---|
| Maximální výstupní tokeny | Celé číslo od 1 do max_output_tokens modelu. |
| Teplota | Číslo od 0 do 2. Prázdná hodnota pole z požadavku vynechá. |
top_p | Číslo od 0 do 1. Prázdná hodnota pole z požadavku vynechá. |
seed | Celé číslo. |
| Stop sekvence | Nejvýše 4, oddělené čárkami. |
response_format | Musí být takový, jaký zvolený model přijímá. Konverzace přesunutá na model bez json_schema nebo bez response_format se zadrží s uvedením důvodu. |
| Obrázky | Při přepnutí na model, který přijímá jen text, se ze zprávy odstraní, s poznámkou. |
Porovnání dvou modelů
Porovnat dva modely v nabídce Více přidá druhý výběr modelu. Každá zpráva pak jde oběma modelům současně, se stejným nastavením, a obě odpovědi stojí vedle sebe, označené A a B. Jednu stranu můžete vygenerovat znovu samostatně. Když jedna strana volá nástroj, výsledek, který pošlete, pokračuje jen na této straně.
Sdílení, export a import
- Kopírovat odkaz pro sdílení zabalí konverzaci do samotného odkazu, do části za
#. Nic se nenahrává. Obrázky, váš klíč a podrobnosti posledního spuštění se vynechají. Kdo odkaz otevře, dostane konverzaci jako novou ve svém vlastním playgroundu. - Konverzace příliš dlouhá pro odkaz se odmítne s poznámkou. Stáhněte ji místo toho jako JSON.
- Stáhnout konverzaci ve formátu JSON uloží konverzaci s jejím nastavením jako soubor. Importovat JSON v panelu konverzací takový soubor otevře.
- Kopírovat jako cURL zkopíruje aktuální požadavek jako jeden příkaz cURL.
Co se kde uchovává
| Co | Kde se uchovává |
|---|---|
| Konverzace, uložené nástroje, nedávné modely, rozložení panelů | V tomto prohlížeči. Nejsou odesílány Shannonu a nepřecházejí s vámi na jiné zařízení. |
| Klíč API | V paměti otevřené karty. Vložený klíč zmizí, když se stránka znovu načte nebo se karta zavře. Po přihlášení se klíč pokaždé čte z vašeho účtu. |
| Události streamu, hlavičky a požadavek posledního kola | V otevřené stránce, dokud se nenačte znovu. |
| Požadavky | Odesílají se z vašeho prohlížeče na API s vaším klíčem. Počítají se proti vašemu zůstatku jako každý jiný požadavek API. |
Klávesnice
| Klávesy | Co dělá |
|---|---|
Enter | Odeslat zprávu. |
Shift + Enter | Začít nový řádek. |
Ctrl + K | Otevřít příkazovou paletu: přepnout endpoint nebo model, nastavit šablonu systému, začít novou konverzaci, přepnout streamování, nástroje nebo porovnání. Na Macu: ⌘ K. |
Esc | Zastavit odpověď, která se právě píše, nebo zavřít otevřený panel na úzké obrazovce. |