Playground

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

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

Запустити Playground

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

Початок

Дайте йому ключ — Після входу playground використовує API-ключ вашого облікового запису й показує ваш баланс. Без входу виберіть Додати ключ і вставте ключ: він зберігається лише в цій вкладці та ніколи не записується.
Виберіть ендпоінт і модель — У верхній панелі розташовані перемикач ендпоінта та вибір моделі. Нова розмова починається на Chat Completions із shannon-3.
Надішліть повідомлення — Введіть текст нижче та натисніть Enter. Кожна відповідь додається до розмови, тож наступне повідомлення її продовжує. Порожній екран пропонує три стартові промпти та готовий приклад виклику інструмента.

Свій ключ ви знайдете й зможете замінити на сторінці 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 пропускається.
Поле введення й системний промпт показують кількість токенів. Для хостованих open-weight моделей це точна кількість із POST /v1/tokenize. Для інших моделей це оцінка, позначена ≈.
Невдалий запит показує, що робити далі: задати ключ, якщо ключ відхилено, поповнити, якщо баланс вичерпано, кількість секунд очікування після надто великої кількості запитів або повторити спробу після помилки сервера.

Налаштування запиту

Кнопка Налаштування відкриває панель із шістьма вкладками. Налаштування належать розмові: кожна розмова зберігає власні.

Вкладка	Що містить
Система	Системний промпт розмови, що надсилається з кожним запитом. П'ять шаблонів заповнюють його, і показується кількість його токенів.
Параметри	Макс. токенів виводу, температура, `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`, затримується з указанням причини.
Зображення	Вилучаються з повідомлення, коли ви перемикаєтеся на модель, що приймає лише текст, із приміткою.

Порівняння двох моделей

Compare two models у меню Ще додає другий вибір моделі. Кожне повідомлення тоді надходить до обох моделей одночасно, з однаковими налаштуваннями, а дві відповіді стоять поруч із позначками A і B. Можна регенерувати лише одну сторону. Коли одна сторона викликає інструмент, результат, який ви надсилаєте, продовжує лише цю сторону.

Копіювати посилання упаковує розмову в саме посилання, у частину після #. Нічого не завантажується на сервер. Зображення, ваш ключ і подробиці останнього запуску не включаються. Хто відкриє посилання, отримає розмову як нову у власному playground.
Розмова, надто довга для посилання, відхиляється з приміткою. Завантажте її натомість як JSON.
Завантажити JSON спілкування зберігає розмову з її налаштуваннями у файл. Імпортувати JSON на панелі розмов відкриває такий файл.
Копіювати як cURL копіює поточний запит як одну команду cURL.

Що де зберігається

Що	Де зберігається
Розмови, збережені інструменти, нещодавні моделі, розкладка панелей	У цьому браузері. Вони не надсилаються до Shannon і не переходять за вами на інший пристрій.
API-ключ	У пам'яті відкритої вкладки. Вставлений ключ зникає, коли сторінка перезавантажується або вкладка закривається. Після входу ключ щоразу читається з вашого облікового запису.
Події стріму, заголовки та запит останнього ходу	У відкритій сторінці, доки вона не перезавантажиться.
Запити	Надсилаються з вашого браузера до API з вашим ключем. Вони рахуються проти вашого балансу, як і будь-який інший запит до API.

Клавіатура

Клавіші	Що робить
`Enter`	Надіслати повідомлення.
`Shift` + `Enter`	Почати новий рядок.
`Ctrl` + `K`	Відкрити палітру команд: перемкнути ендпоінт або модель, задати системний шаблон, почати нову розмову, перемкнути стрімінг, інструменти чи порівняння. На Mac: ⌘ K.
`Esc`	Зупинити відповідь, що пишеться, або закрити відкриту панель на вузькому екрані.