Przejdź do treści
Plac zabaw API

Plac zabaw API

Interaktywny

Wypróbuj każdy model i endpoint w przeglądarce z własnym kluczem — wynik w streamingu, inspektor zapytań i wygenerowany kod, który wkleisz prosto do swojej aplikacji.

Uruchom Playground

Playground to konsola czatu dla API pod adresem /docs/playground. Rozmawiasz z modelem, a playground wysyła takie same zapytania jak Twój kod: do jednego z trzech endpointów, z modelem, promptem systemowym, parametrami i narzędziami, które ustawisz. Każde zapytanie można odczytać jako kod i jako surowe zdarzenia streamu.

Start

  • Podaj klucz — Po zalogowaniu playground używa klucza API Twojego konta i pokazuje Twoje saldo. Bez logowania wybierz Dodaj klucz i wklej klucz: jest trzymany tylko w tej karcie i nigdy nie jest zapisywany.
  • Wybierz endpoint i model — Górny pasek zawiera przełącznik endpointu i wybór modelu. Nowa rozmowa zaczyna się w Chat Completions z shannon-3.
  • Wyślij wiadomość — Wpisz poniżej i naciśnij Enter. Każda odpowiedź dołącza do rozmowy, więc następna wiadomość ją kontynuuje. Pusty ekran proponuje trzy startowe prompty i gotowy przykład wywołania narzędzia.

Swój klucz znajdziesz i zrotujesz na stronie Keys & usage. Keys & usage

Endpointy i modele

Przełącznik endpointu decyduje, jaki format zapytania buduje playground. Możesz go zmienić w środku rozmowy; wiadomości zostają.

Endpoint Zapytanie, które wysyła Dokumentacja
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Format Anthropic

Wybór modelu wyświetla to, co zwraca GET /v1/models. Można w nim szukać, trzyma Twoje ostatnie modele na górze i pokazuje przy każdym modelu cenę za 1M tokenów, okno kontekstu oraz oznaczenia narzędzi, wejścia obrazów, wnioskowania i ustrukturyzowanego wyjścia.

Rozmowa

  • Odpowiedzi spływają do rozmowy w miarę pisania. Wnioskowanie modelu jest pokazane w osobnym bloku, który można zwinąć.
  • Pod każdą odpowiedzią: czas do pierwszego tokenu, tokeny na sekundę, czas, który upłynął, tokeny wejścia i wyjścia z częściami z cache i wnioskowania, oszacowanie kosztu tury, przyczyna zakończenia i id odpowiedzi.
  • Swoją wiadomość można edytować i wysłać ponownie od tego miejsca. Odpowiedź można wygenerować ponownie. Wiadomość można usunąć, a usunięcie można cofnąć przez kilka sekund.
  • Stop lub klawisz Esc kończy odpowiedź, która jest pisana.
  • Obrazy dołącza się przyciskiem obrazu, przez wklejenie lub upuszczenie pliku, dla modeli przyjmujących obrazy. Obraz jest skalowany do 1,568 pikseli na dłuższym boku przed wysłaniem. Plik powyżej 30 MB jest pomijany.
  • Pole wiadomości i prompt systemowy pokazują liczbę tokenów. Dla hostowanych modeli open-weight jest to dokładna liczba z POST /v1/tokenize. Dla pozostałych modeli to oszacowanie, oznaczone ≈.
  • Nieudane zapytanie pokazuje, co zrobić dalej: ustawić klucz, gdy klucz odrzucono, doładować, gdy saldo zostało zużyte, ile sekund czekać po zbyt wielu zapytaniach, albo ponowić próbę po błędzie serwera.

Ustawienia zapytania

Przycisk Ustawienia otwiera panel z sześcioma kartami. Ustawienia należą do rozmowy: każda rozmowa ma własne.

Karta Co zawiera
System Prompt systemowy rozmowy, wysyłany z każdym zapytaniem. Pięć szablonów go wypełnia, a pokazywana jest jego liczba tokenów.
Parametry Maks. tokenów wyjścia, temperatura, top_p, wysiłek wnioskowania, sekwencje zatrzymania, seed oraz przełączniki streamingu i wyszukiwania w sieci. Kontrolka, dla której wybrany endpoint nie ma pola, jest wyłączona i oznaczona.
Narzędzia Definicje narzędzi wysyłane z zapytaniem: cztery gotowe (get_weather, read_file, run_shell, web_search) albo Twoja własna definicja jako JSON, oraz tool_choice (auto, none, required lub jedno narzędzie z nazwy). Gdy model wywołuje narzędzie, rozmowa pokazuje wywołanie z polem na wynik. Przy włączonym Podpowiadaj przykładowe wyniki jedno kliknięcie wstawia przykładowy wynik. Możesz też wpisać własny, a potem go wysłać, aby kontynuować turę.
Ustrukturyzowane response_format: text, json_object lub json_schema z nazwą schematu i schematem JSON. Gdy schemat jest ustawiony, ostatnia odpowiedź jest sprawdzana względem niego i oznaczana w rozmowie jako zgodna lub nie. Karta jest wyłączona w endpoincie Messages, a opcja, której wybrany model nie przyjmuje, nie jest oferowana.
Kod Zapytanie bieżącej rozmowy jako kod cURL, Python, Node lub Go, zbudowany z rozmowy i jej ustawień. Klucz jest wypisany jako YOUR_API_KEY. Kod można skopiować lub otworzyć w dużym widoku.
Zdarzenia Ostatnia tura tak, jak przeszła przez sieć: każde zdarzenie streamu z przesunięciem czasu i filtrem, złożona odpowiedź, nagłówki odpowiedzi (x-request-id, content-type, retry-after, date) i treść zapytania. Są trzymane do przeładowania strony.

Sprawdzanie danych

Wpisywane wartości są sprawdzane przed wysłaniem zapytania. Wartość spoza zakresu jest zaznaczona przy swoim polu, a wysyłanie jest wstrzymane, dopóki jej nie poprawisz.

Ustawienie Sprawdzenie
Maks. tokenów wyjścia Liczba całkowita od 1 do max_output_tokens modelu.
Temperatura Liczba od 0 do 2. Puste pole pomija je w zapytaniu.
top_p Liczba od 0 do 1. Puste pole pomija je w zapytaniu.
seed Liczba całkowita.
Sekwencje zatrzymania Najwyżej 4, oddzielone przecinkami.
response_format Musi być jednym z tych, które przyjmuje wybrany model. Rozmowa przeniesiona do modelu bez json_schema lub bez response_format jest wstrzymana z podaniem powodu.
Obrazy Usuwane z wiadomości po przełączeniu na model przyjmujący tylko tekst, z komunikatem.

Porównanie dwóch modeli

Porównaj dwa modele w menu Więcej dodaje drugi wybór modelu. Każda wiadomość trafia wtedy do obu modeli jednocześnie, z tymi samymi ustawieniami, a obie odpowiedzi stoją obok siebie, oznaczone A i B. Możesz wygenerować ponownie samą jedną stronę. Gdy jedna strona wywołuje narzędzie, wysłany przez Ciebie wynik kontynuuje tylko tę stronę.

Udostępnianie, eksport i import

  • Kopiuj link do udostępnienia pakuje rozmowę w sam link, w część po #. Nic nie jest przesyłane. Obrazy, Twój klucz i szczegóły ostatniego uruchomienia są pomijane. Kto otworzy link, dostaje rozmowę jako nową w swoim playground.
  • Rozmowa zbyt długa na link jest odrzucana z komunikatem. Pobierz ją zamiast tego jako JSON.
  • Pobierz JSON rozmowy zapisuje rozmowę wraz z ustawieniami jako plik. Importuj JSON w panelu rozmów otwiera taki plik.
  • Kopiuj jako cURL kopiuje bieżące zapytanie jako jedno polecenie cURL.

Co jest przechowywane gdzie

Co Gdzie jest przechowywane
Rozmowy, zapisane narzędzia, ostatnie modele, układ paneli W tej przeglądarce. Nie są wysyłane do Shannon i nie podążają za Tobą na inne urządzenie.
Klucz API W pamięci otwartej karty. Wklejony klucz znika po przeładowaniu strony lub zamknięciu karty. Po zalogowaniu klucz jest za każdym razem odczytywany z Twojego konta.
Zdarzenia streamu, nagłówki i zapytanie ostatniej tury W otwartej stronie, do jej przeładowania.
Zapytania Wysyłane z Twojej przeglądarki do API z Twoim kluczem. Są liczone względem Twojego salda jak każde inne zapytanie API.

Klawiatura

Klawisze Co robi
Enter Wyślij wiadomość.
Shift + Enter Zacznij nowy wiersz.
Ctrl + K Otwórz paletę poleceń: przełącz endpoint lub model, ustaw szablon systemowy, zacznij nową rozmowę, przełącz streaming, narzędzia lub porównanie. Na Macu: ⌘ K.
Esc Zatrzymaj odpowiedź, która jest pisana, albo zamknij otwarty panel na wąskim ekranie.

Uruchom Playground