Playground
InteraktivnoIsprobajte svaki model i endpoint u pregledniku sa svojim ključem — streaming izlaz, inspektor zahtjeva i generirani kod koji možete zalijepiti izravno u svoju aplikaciju.
Playground je chat konzola za API na /docs/playground. Razgovarate s modelom, a playground šalje iste zahtjeve koje bi poslao vaš kod: na jedan od tri endpointa, s modelom, system promptom, parametrima i alatima koje postavite. Svaki zahtjev može se pročitati kao kod i kao sirovi događaji streama.
Početak
- Dajte mu ključ — Kada ste prijavljeni, playground koristi API ključ vašeg računa i prikazuje vaše stanje. Ako niste prijavljeni, odaberite Dodaj ključ i zalijepite ključ: čuva se samo u ovoj kartici i nikada se ne sprema.
- Odaberite endpoint i model — Gornja traka sadrži prekidač endpointa i birač modela. Novi razgovor započinje na Chat Completions s
shannon-3. - Pošaljite poruku — Upišite ispod i pritisnite Enter. Svaki odgovor pridružuje se razgovoru, pa ga sljedeća poruka nastavlja. Prazan zaslon nudi tri početna prompta i gotov primjer poziva alata.
Svoj ključ pronalazite i mijenjate na stranici Ključevi i upotreba. Ključevi i upotreba
Endpointi i modeli
Prekidač endpointa određuje koji format zahtjeva playground gradi. Možete ga promijeniti usred razgovora; poruke ostaju.
| Endpoint | Zahtjev koji šalje | Referenca |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Anthropic format |
Birač modela navodi ono što vraća GET /v1/models. Može se pretraživati, drži vaše nedavne modele na vrhu i za svaki model prikazuje cijenu za 1M tokena, kontekstni prozor i oznake za alate, ulaz slika, razmišljanje i strukturirani izlaz.
Razgovor
- Odgovori se streamaju u razgovor dok se pišu. Razmišljanje modela prikazuje se u zasebnom bloku koji možete sklopiti.
- Ispod svakog odgovora: vrijeme do prvog tokena, tokena u sekundi, proteklo vrijeme, ulazni i izlazni tokeni s cacheiranim dijelovima i dijelovima razmišljanja, procjena troška okreta, razlog završetka i id odgovora.
- Vaša poruka može se urediti i ponovno poslati od te točke. Odgovor se može ponovno generirati. Poruka se može izbrisati, a brisanje se može poništiti nekoliko sekundi.
- Zaustavi ili tipka Esc prekida odgovor koji se piše.
- Slike se prilažu gumbom za sliku, lijepljenjem ili ispuštanjem datoteke, za modele koji primaju slike. Slika se prije slanja smanjuje na 1,568 piksela po dužoj stranici. Datoteka veća od 30 MB se preskače.
- Polje za unos i system prompt prikazuju broj tokena. Za hostirane open-weight modele to je točan broj iz
POST /v1/tokenize. Za ostale modele to je procjena, označena s≈. - Neuspjeli zahtjev prikazuje što učiniti dalje: postaviti ključ ako je ključ odbijen, dopuniti ako je stanje potrošeno, sekunde čekanja nakon previše zahtjeva ili ponovni pokušaj nakon greške poslužitelja.
Postavke zahtjeva
Gumb Postavke otvara panel sa šest kartica. Postavke pripadaju razgovoru: svaki razgovor čuva svoje.
| Kartica | Što sadrži |
|---|---|
| System | System prompt razgovora, poslan sa svakim zahtjevom. Pet predložaka ga popunjava, a prikazuje se i njegov broj tokena. |
| Parametri | Maks. izlaznih tokena, temperatura, top_p, razina razmišljanja, stop sekvence, seed te prekidači za streaming i web pretragu. Kontrola za koju odabrani endpoint nema polje isključena je i označena. |
| Alati | Definicije alata poslane sa zahtjevom: četiri gotove postavke (get_weather, read_file, run_shell, web_search) ili vaša vlastita definicija kao JSON, te tool_choice (auto, none, required ili jedan alat po imenu). Kada model pozove alat, razgovor prikazuje poziv s okvirom za rezultat. Uz uključeno Ponudi primjere rezultata jedan klik popunjava primjer rezultata. Možete upisati i vlastiti, a zatim ga poslati da se okret nastavi. |
| Strukturirano | response_format: text, json_object ili json_schema s nazivom sheme i JSON shemom. Kada je shema postavljena, zadnji odgovor provjerava se prema njoj i u razgovoru se označava podudara li se ili ne. Kartica je isključena na endpointu Messages, a opcija koju odabrani model ne prima ne nudi se. |
| Kod | Zahtjev trenutačnog razgovora kao cURL, Python, Node ili Go kod, izgrađen iz razgovora i njegovih postavki. Ključ je ispisan kao YOUR_API_KEY. Kod se može kopirati ili otvoriti u velikom prikazu. |
| Događaji | Zadnji okret onako kako je prošao žicom: svaki događaj streama s vremenskim pomakom i filterom, sastavljeni odgovor, zaglavlja odgovora (x-request-id, content-type, retry-after, date) i tijelo zahtjeva. Čuvaju se do ponovnog učitavanja stranice. |
Provjere unosa
Vrijednosti koje upišete provjeravaju se prije slanja zahtjeva. Vrijednost izvan raspona označava se na svom polju, a slanje je zadržano dok se ne ispravi.
| Postavka | Provjera |
|---|---|
| Maks. izlaznih tokena | Cijeli broj od 1 do max_output_tokens modela. |
| Temperatura | Broj od 0 do 2. Prazno polje izostavlja se iz zahtjeva. |
top_p | Broj od 0 do 1. Prazno polje izostavlja se iz zahtjeva. |
seed | Cijeli broj. |
| Stop sekvence | Najviše 4, odvojene zarezima. |
response_format | Mora biti jedan koji odabrani model prima. Razgovor prebačen na model bez json_schema ili bez response_format zadržava se uz navedeni razlog. |
| Slike | Uklanjaju se iz poruke kada prijeđete na model koji prima samo tekst, uz napomenu. |
Usporedba dva modela
Usporedi dva modela u izborniku Više dodaje drugi birač modela. Svaka poruka tada ide na oba modela istodobno, s istim postavkama, a dva odgovora stoje jedan pokraj drugog, označena s A i B. Jednu stranu možete zasebno ponovno generirati. Kada jedna strana pozove alat, rezultat koji pošaljete nastavlja samo tu stranu.
Dijeljenje, izvoz i uvoz
- Kopiraj poveznicu za dijeljenje pakira razgovor u samu poveznicu, u dio iza
#. Ništa se ne učitava na poslužitelj. Slike, vaš ključ i pojedinosti zadnjeg pokretanja izostavljaju se. Tko otvori poveznicu dobiva razgovor kao novi u svom playgroundu. - Razgovor predug za poveznicu odbija se uz napomenu. Preuzmite ga umjesto toga kao JSON.
- Preuzmi JSON razgovora sprema razgovor s njegovim postavkama kao datoteku. Uvezi JSON u panelu razgovora otvara takvu datoteku.
- Kopiraj kao cURL kopira trenutačni zahtjev kao jednu cURL naredbu.
Što se gdje čuva
| Što | Gdje se čuva |
|---|---|
| Razgovori, spremljeni alati, nedavni modeli, raspored panela | U ovom pregledniku. Ne šalju se Shannonu i ne prate vas na drugi uređaj. |
| API ključ | U memoriji otvorene kartice. Zalijepljeni ključ nestaje kada se stranica ponovno učita ili se kartica zatvori. Kada ste prijavljeni, ključ se svaki put čita iz vašeg računa. |
| Događaji streama, zaglavlja i zahtjev zadnjeg okreta | U otvorenoj stranici, do ponovnog učitavanja. |
| Zahtjevi | Šalju se iz vašeg preglednika na API s vašim ključem. Računaju se na teret vašeg stanja kao i svaki drugi API zahtjev. |
Tipkovnica
| Tipke | Što radi |
|---|---|
Enter | Pošalji poruku. |
Shift + Enter | Započni novi redak. |
Ctrl + K | Otvori paletu naredbi: promijeni endpoint ili model, postavi system predložak, započni novi razgovor, uključi/isključi streaming, alate ili usporedbu. Na Macu: ⌘ K. |
Esc | Zaustavi odgovor koji se piše ili zatvori otvoreni panel na uskom zaslonu. |