Preskočiť na obsah
Playground

Playground

Interaktívne

Vyskúšajte každý model a endpoint v prehliadači s vlastným kľúčom — streamovaný výstup, inšpektor requestov a vygenerovaný kód, ktorý môžete vložiť priamo do svojej aplikácie.

Spustiť Playground

Playground je chatová konzola pre API na /docs/playground. Rozprávate sa s modelom a playground posiela rovnaké requesty, aké by poslal váš kód: na jeden z troch endpointov, s modelom, systémovým promptom, parametrami a nástrojmi, ktoré nastavíte. Každý request si možno prečítať späť ako kód aj ako surové udalosti streamu.

Začiatok

  • Dajte mu kľúč — Po prihlásení playground používa API kľúč vášho účtu a ukazuje váš zostatok. Bez prihlásenia zvoľte Pridať kľúč a vložte kľúč: uchová sa len v tejto karte a nikdy sa neukladá.
  • Vyberte endpoint a model — Horná lišta obsahuje prepínač endpointu a výber modelu. Nová konverzácia začína na Chat Completions s shannon-3.
  • Odošlite správu — Píšte dolu a stlačte Enter. Každá odpoveď sa pripojí ku konverzácii, takže ďalšia správa v nej pokračuje. Prázdna obrazovka ponúka tri úvodné prompty a hotový príklad volania nástroja.

Svoj kľúč nájdete a obnovíte na stránke Kľúče a využitie. Kľúče a využitie

Endpointy a modely

Prepínač endpointu určuje, aký formát requestu playground zostavuje. Môžete ho zmeniť uprostred konverzácie; správy zostanú.

Endpoint Request, ktorý posiela Referencia
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Formát Anthropic

Výber modelu uvádza to, čo vracia GET /v1/models. Dá sa v ňom vyhľadávať, vaše nedávne modely drží navrchu a pri každom modeli ukazuje cenu za 1M tokenov, kontextové okno a značky pre nástroje, vstup obrázkov, uvažovanie a štruktúrovaný výstup.

Konverzácia

  • Odpovede sa do vlákna streamujú tak, ako sa píšu. Uvažovanie modelu sa zobrazuje vo vlastnom bloku, ktorý možno zbaliť.
  • Pod každou odpoveďou: čas do prvého tokenu, tokeny za sekundu, uplynutý čas, vstupné a výstupné tokeny s cachovanou časťou a časťou uvažovania, odhad ceny kroku, dôvod ukončenia a id odpovede.
  • Vašu správu možno upraviť a poslať znova od toho miesta. Odpoveď možno vygenerovať znova. Správu možno zmazať a zmazanie možno niekoľko sekúnd vrátiť späť.
  • Zastaviť alebo kláves Esc ukončí odpoveď, ktorá sa práve píše.
  • Obrázky sa pripájajú tlačidlom obrázka, vložením alebo pustením súboru, pre modely, ktoré obrázky berú. Obrázok sa pred odoslaním zmenší na 1,568 pixelov na dlhšej strane. Súbor nad 30 MB sa preskočí.
  • Pole správy a systémový prompt ukazujú počet tokenov. Pri hostovaných open-weight modeloch je to presný počet z POST /v1/tokenize. Pri ostatných modeloch je to odhad, označený ≈.
  • Zlyhaný request ukáže, čo robiť ďalej: nastaviť kľúč, keď bol kľúč odmietnutý, dobiť, keď sa zostatok minul, počet sekúnd čakania po príliš mnohých requestoch, alebo zopakovanie po chybe servera.

Nastavenia requestu

Tlačidlo Nastavenia otvorí panel so šiestimi kartami. Nastavenia patria ku konverzácii: každá konverzácia si drží vlastné.

Karta Čo obsahuje
Systém Systémový prompt konverzácie, posielaný s každým requestom. Vyplní ho päť šablón a zobrazí sa jeho počet tokenov.
Parametre Max. výstupné tokeny, teplota, top_p, úsilie pri uvažovaní, stop sekvencie, seed a prepínače streamovania a webového vyhľadávania. Ovládací prvok, pre ktorý vybraný endpoint nemá pole, je vypnutý a označený.
Nástroje Definície nástrojov posielané s requestom: štyri predvoľby (get_weather, read_file, run_shell, web_search) alebo vaša vlastná definícia ako JSON a tool_choice (auto, none, required alebo jeden nástroj podľa názvu). Keď model volá nástroj, vlákno ukáže volanie s poľom na výsledok. So zapnutým Ponúkať ukážkové výsledky vyplní ukážkový výsledok jedno kliknutie. Môžete napísať aj vlastný a potom ho poslať, aby krok pokračoval.
Štruktúrovaný response_format: text, json_object alebo json_schema s názvom schémy a schémou JSON. Pri nastavenej schéme sa posledná odpoveď podľa nej skontroluje a vo vlákne sa označí, či zodpovedá, alebo nie. Karta je na endpointe Messages vypnutá a možnosť, ktorú vybraný model neprijíma, sa neponúka.
Kód Request aktuálnej konverzácie ako kód cURL, Python, Node alebo Go, zostavený z konverzácie a jej nastavení. Kľúč sa vypíše ako YOUR_API_KEY. Kód možno skopírovať alebo otvoriť vo veľkom zobrazení.
Udalosti Posledný krok tak, ako prešiel po sieti: každá udalosť streamu s časovým posunom a filtrom, zložená odpoveď, hlavičky odpovede (x-request-id, content-type, retry-after, date) a telo requestu. Uchovávajú sa, kým sa stránka nenačíta znova.

Kontroly vstupu

Hodnoty, ktoré zadáte, sa pred odoslaním requestu skontrolujú. Hodnota mimo rozsahu sa označí pri svojom poli a odoslanie sa zadrží, kým ju neopravíte.

Nastavenie Kontrola
Max. výstupné tokeny Celé číslo od 1 po max_output_tokens modelu.
Teplota Číslo od 0 do 2. Prázdne pole sa z requestu vynechá.
top_p Číslo od 0 do 1. Prázdne pole sa z requestu vynechá.
seed Celé číslo.
Stop sekvencie Najviac 4, oddelené čiarkami.
response_format Musí byť taký, aký vybraný model prijíma. Konverzácia presunutá na model bez json_schema alebo bez response_format sa zadrží s uvedením dôvodu.
Obrázky Pri prepnutí na model, ktorý berie len text, sa zo správy odstránia, s poznámkou.

Porovnanie dvoch modelov

Porovnať dva modely v ponuke Viac pridá druhý výber modelu. Každá správa potom ide na oba modely naraz, s rovnakými nastaveniami, a obe odpovede stoja vedľa seba, označené A a B. Jednu stranu môžete vygenerovať znova samostatne. Keď jedna strana volá nástroj, výsledok, ktorý pošlete, pokračuje len na tej strane.

Zdieľanie, export a import

  • Kopírovať odkaz na zdieľanie zabalí konverzáciu priamo do odkazu, do časti za #. Nič sa nenahráva. Obrázky, váš kľúč a podrobnosti posledného behu sa vynechajú. Kto odkaz otvorí, dostane konverzáciu ako novú vo svojom vlastnom playgrounde.
  • Konverzácia príliš dlhá na odkaz sa odmietne s poznámkou. Stiahnite ju namiesto toho ako JSON.
  • Stiahnuť JSON konverzácie uloží konverzáciu s jej nastaveniami ako súbor. Importovať JSON v paneli konverzácií takýto súbor otvorí.
  • Kopírovať ako cURL skopíruje aktuálny request ako jeden príkaz cURL.

Čo sa kde uchováva

Čo Kde sa uchováva
Konverzácie, uložené nástroje, nedávne modely, rozloženie panelov V tomto prehliadači. Neposielajú sa do Shannon a nenasledujú vás na iné zariadenie.
API kľúč V pamäti otvorenej karty. Vložený kľúč zmizne pri opätovnom načítaní stránky alebo zatvorení karty. Po prihlásení sa kľúč zakaždým číta z vášho účtu.
Udalosti streamu, hlavičky a request posledného kroku V otvorenej stránke, kým sa nenačíta znova.
Requesty Posielajú sa z vášho prehliadača na API s vaším kľúčom. Počítajú sa voči vášmu zostatku ako každý iný request API.

Klávesnica

Klávesy Čo robí
Enter Odoslať správu.
Shift + Enter Začať nový riadok.
Ctrl + K Otvoriť paletu príkazov: prepnúť endpoint alebo model, nastaviť šablónu systému, začať novú konverzáciu, prepnúť streamovanie, nástroje alebo porovnanie. Na Macu: ⌘ K.
Esc Zastaviť odpoveď, ktorá sa práve píše, alebo zavrieť otvorený panel na úzkej obrazovke.

Spustiť Playground