Песочница API

Интерактивный

Пробуйте все модели и эндпоинты в браузере с вашим собственным ключом — стриминг вывода, инспектор запросов и сгенерированный код, который можно сразу вставить в ваше приложение.

Запустить Playground

Playground — это чат-консоль для API по адресу /docs/playground. Вы общаетесь с моделью, а Playground отправляет те же запросы, что отправил бы ваш код: на один из трех эндпоинтов, с заданными вами моделью, системным промптом, параметрами и инструментами. Каждый запрос можно просмотреть в виде кода и в виде необработанных событий потока.

Начало работы

Добавьте ключ — Если вы вошли в аккаунт, Playground использует API-ключ вашего аккаунта и показывает ваш баланс. Если не вошли, выберите Add key и вставьте ключ: он хранится только в этой вкладке и никогда не сохраняется.
Выберите эндпоинт и модель — В верхней панели находятся переключатель эндпоинта и выбор модели. Новый разговор начинается на Chat Completions с shannon-3.
Отправьте сообщение — Введите текст внизу и нажмите Enter. Каждый ответ становится частью разговора, поэтому следующее сообщение его продолжает. На пустом экране предлагаются три стартовых промпта и готовый пример вызова инструмента.

Свой ключ вы найдете и сможете заменить на странице 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 токенов, контекстное окно и значки инструментов, ввода изображений, reasoning и структурированного вывода.

Разговор

Ответы поступают в ленту потоком по мере написания. Reasoning модели показывается в отдельном блоке, который можно свернуть.
Под каждым ответом: время до первого токена, токенов в секунду, прошедшее время, входные и выходные токены с кэшированной частью и частью reasoning, оценка стоимости хода, причина завершения и id ответа.
Ваше сообщение можно отредактировать и отправить заново с этого места. Ответ можно перегенерировать. Сообщение можно удалить, и удаление можно отменить в течение нескольких секунд.
Кнопка Stop или клавиша Esc прерывает ответ, который пишется.
Изображения для моделей, которые их принимают, добавляются кнопкой изображения, вставкой или перетаскиванием файла. Перед отправкой изображение уменьшается до 1,568 пикселей по длинной стороне. Файл больше 30 MB пропускается.
Поле ввода и системный промпт показывают число токенов. Для размещенных моделей с открытыми весами это точное число из POST /v1/tokenize. Для остальных моделей это оценка, отмеченная знаком ≈.
После неудачного запроса показывается, что делать дальше: задать ключ, если ключ отклонен; пополнить баланс, если он исчерпан; подождать указанное число секунд после слишком большого числа запросов; или повторить запрос после ошибки сервера.

Настройки запроса

Кнопка Настройки открывает панель с шестью вкладками. Настройки принадлежат разговору: у каждого разговора свои.

Вкладка	Что содержит
Система	Системный промпт разговора, отправляемый с каждым запросом. Его заполняют пять шаблонов, и показывается число его токенов.
Параметры	Максимум токенов вывода, температура, `top_p`, усилие reasoning, стоп-последовательности, `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`, не отправляется, и указывается причина.
Изображения	Удаляются из сообщения при переходе на модель, принимающую только текст, с пометкой об этом.

Сравнение двух моделей

Пункт Compare two models в меню Еще добавляет второй выбор модели. Тогда каждое сообщение уходит обеим моделям одновременно, с одними и теми же настройками, а два ответа стоят рядом и помечены A и B. Можно перегенерировать только одну сторону. Если одна сторона вызывает инструмент, отправленный вами результат продолжает только эту сторону.

Copy share link упаковывает разговор в саму ссылку, в часть после #. Ничего не загружается на сервер. Изображения, ваш ключ и данные последнего запуска не включаются. Тот, кто откроет ссылку, получит разговор как новый в своем Playground.
Разговор, слишком длинный для ссылки, отклоняется с пояснением. Скачайте его в виде JSON.
Download conversation JSON сохраняет разговор вместе с настройками в файл. Import JSON на панели разговоров открывает такой файл.
Copy as cURL копирует текущий запрос одной командой cURL.

Что и где хранится

Что	Где хранится
Разговоры, сохраненные инструменты, недавние модели, раскладка панелей	В этом браузере. На Shannon они не отправляются и на другое устройство не переносятся.
API-ключ	В памяти открытой вкладки. Вставленный ключ исчезает при перезагрузке страницы или закрытии вкладки. Если вы вошли в аккаунт, ключ каждый раз читается из аккаунта.
События потока, заголовки и запрос последнего хода	На открытой странице, до ее перезагрузки.
Запросы	Отправляются из вашего браузера в API с вашим ключом. Они списываются с баланса, как любые другие запросы к API.

Клавиатура

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