Playground

Интерактивно

Опитайте всеки модел и ендпоинт в браузъра със собствения си ключ — стрийминг на изхода, инспектор на заявките и генериран код, който можете да поставите направо в приложението си.

Стартирайте Playground

Playground е чат конзола за API на /docs/playground. Разговаряте с модел, а Playground изпраща същите заявки, които би изпратил Вашият код: към един от трите ендпоинта, с модела, системния prompt, параметрите и инструментите, които сте задали. Всяка заявка може да се прочете обратно като код и като суров стрийм от събития.

Начало

Дайте му ключ — След вход Playground използва API ключа на Вашия акаунт и показва баланса Ви. Без вход изберете Добави ключ и поставете ключ: той се пази само в този таб и никога не се записва.
Изберете ендпоинт и модел — Горната лента съдържа превключвателя на ендпоинта и избора на модел. Нов разговор започва с Chat Completions и shannon-3.
Изпратете съобщение — Напишете отдолу и натиснете Enter. Всеки отговор се присъединява към разговора, така че следващото съобщение го продължава. Празният екран предлага три примерни prompt-а и готов пример за извикване на инструмент.

Ключа си намирате и подменяте на страницата Keys & usage. Keys & usage

Ендпоинти и модели

Превключвателят на ендпоинта определя в какъв формат на заявката Playground изгражда заявките. Можете да го смените по средата на разговор; съобщенията остават.

Ендпоинт	Заявка, която изпраща	Справка
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	Anthropic формат

Изборът на модел изброява това, което връща GET /v1/models. В него може да се търси, държи последните Ви модели най-отгоре и показва за всеки модел цената на 1M токена, контекстния прозорец и знаци за инструменти, вход с изображения, разсъждения и структуриран изход.

Разговорът

Отговорите се стрийват в нишката, докато се пишат. Разсъжденията на модела се показват в отделен блок, който можете да сгънете.
Под всеки отговор: време до първия токен, токени в секунда, изминало време, входни и изходни токени с кешираната част и частта за разсъждения, оценка на цената на хода, причината за завършване и id на отговора.
Ваше съобщение може да се редактира и да се изпрати отново от тази точка. Отговор може да се генерира наново. Съобщение може да се изтрие, а изтриването може да се отмени за няколко секунди.
Спри или клавишът Esc прекратява отговор, който се пише.
Изображенията се прикачват с бутона за изображение, чрез поставяне или чрез пускане на файл, за модели, които приемат изображения. Изображението се мащабира до 1,568 пиксела по дългата си страна, преди да бъде изпратено. Файл над 30 MB се пропуска.
Полето за писане и системният prompt показват брой токени. За хостваните open-weight модели това е точният брой от POST /v1/tokenize. За другите модели е приблизителна оценка, отбелязана с ≈.
Неуспешната заявка показва какво да направите: да зададете ключ, когато ключът е отхвърлен, да дозаредите, когато балансът е изчерпан, секундите за изчакване след твърде много заявки или повторен опит след грешка на сървъра.

Настройки на заявката

Бутонът Настройки отваря панел с шест раздела. Настройките принадлежат на разговора: всеки разговор пази своите.

Раздел	Какво съдържа
Система	Системният prompt на разговора, изпращан с всяка заявка. Пет шаблона го попълват и се показва броят му токени.
Параметри	Макс. изходни токени, температура, `top_p`, усилия за разсъждения, последователности за спиране, `seed` и превключвателите за стрийминг и уеб търсене. Контрол, за който избраният ендпоинт няма поле, е изключен и отбелязан.
Инструменти	Дефиниции на инструменти, изпратени със заявката: четири предварителни настройки (`get_weather`, `read_file`, `run_shell`, `web_search`) или Ваша собствена дефиниция като JSON, и `tool_choice` (`auto`, `none`, `required` или един инструмент по име). Когато моделът извика инструмент, нишката показва извикването с поле за резултата. При включено Offer sample results едно щракване попълва примерен резултат. Можете да напишете и свой, после да го изпратите, за да продължите хода.
Структурирано	`response_format`: `text`, `json_object` или `json_schema` с име на схема и JSON схема. При зададена схема последният отговор се проверява спрямо нея и в нишката се отбелязва дали съответства. Разделът е изключен на ендпоинта Messages, а опция, която избраният модел не приема, не се предлага.
Код	Заявката на текущия разговор като код за cURL, Python, Node или Go, изграден от разговора и настройките му. Ключът се изписва като `YOUR_API_KEY`. Кодът може да се копира или да се отвори в голям изглед.
Събития	Последният ход така, както е минал по мрежата: всяко събитие на стрийма с времевото си отместване и филтър, сглобеният отговор, хедърите на отговора (`x-request-id`, `content-type`, `retry-after`, `date`) и тялото на заявката. Те се пазят, докато страницата не се презареди.

Проверки на въведеното

Стойностите, които въвеждате, се проверяват, преди заявката да бъде изпратена. Стойност извън диапазона се отбелязва на своето поле и изпращането се задържа, докато не бъде поправена.

Настройка	Проверка
Макс. изходни токени	Цяло число от 1 до `max_output_tokens` на модела.
Температура	Число от 0 до 2. Празното оставя полето извън заявката.
`top_p`	Число от 0 до 1. Празното оставя полето извън заявката.
`seed`	Цяло число.
Последователности за спиране	Най-много 4, разделени със запетаи.
`response_format`	Трябва да е такъв, който избраният модел приема. Разговор, преместен към модел без `json_schema` или без `response_format`, се задържа с посочена причина.
Изображения	Премахват се от съобщението, когато преминете към модел, който приема само текст, с бележка.

Сравняване на два модела

Сравняване на два модела в менюто Още добавя втори избор на модел. Всяко съобщение тогава отива към двата модела едновременно, със същите настройки, а двата отговора стоят един до друг, отбелязани с A и B. Можете да генерирате наново само едната страна. Когато едната страна извика инструмент, резултатът, който изпратите, продължава само тази страна.

Копирай връзка за споделяне пакетира разговора в самата връзка, в частта след #. Нищо не се качва. Изображенията, Вашият ключ и подробностите за последното изпълнение се пропускат. Който отвори връзката, получава разговора като нов в собствения си Playground.
Разговор, прекалено дълъг за връзка, се отказва с бележка. Изтеглете го вместо това като JSON.
Изтегли JSON на разговора запазва разговора с настройките му като файл. Импортирай JSON в панела с разговори отваря такъв файл.
Копирай като cURL копира текущата заявка като една команда cURL.

Какво къде се пази

Какво	Къде се пази
Разговори, запазени инструменти, последни модели, разположение на панелите	В този браузър. Не се изпращат към Shannon и не Ви следват на друго устройство.
API ключ	В паметта на отворения таб. Поставен ключ изчезва, когато страницата се презареди или табът се затвори. След вход ключът се чете от Вашия акаунт всеки път.
Събития на стрийма, хедъри и заявка на последния ход	В отворената страница, докато не се презареди.
Заявки	Изпращат се от Вашия браузър към API с Вашия ключ. Броят се от баланса Ви като всяка друга API заявка.

Клавиатура

Клавиши	Какво прави
`Enter`	Изпраща съобщението.
`Shift` + `Enter`	Започва нов ред.
`Ctrl` + `K`	Отваря командното меню: смяна на ендпоинт или модел, задаване на системен шаблон, нов разговор, превключване на стрийминг, инструменти или сравняване. На Mac: ⌘ K.
`Esc`	Спира отговора, който се пише, или затваря отворен панел на тесен екран.