API Playground

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

Пробајте го секој модел и endpoint во прелистувачот со ваш клуч — streaming излез, инспектор на барања и генериран код што можете директно да го залепите во апликацијата.

Отвори Playground

Playground е конзола за разговор со API-то на /docs/playground. Разговарате со модел, а playground-от ги испраќа истите барања што би ги испратил вашиот код: до еден од трите ендпоинти, со моделот, system prompt-от, параметрите и алатките што ги поставувате. Секое барање може да се прочита назад како код и како сурови настани на streaming.

Почеток

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

Го наоѓате и менувате вашиот клуч на страницата Клучеви и употреба. Клучеви и употреба

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

Прекинувачот за ендпоинт одредува кој формат на барање го гради playground-от. Можете да го смените среде разговор; пораките остануваат.

Ендпоинт	Барање што го испраќа	Референца
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	Anthropic формат

Избирачот на модел го наведува она што го враќа GET /v1/models. Може да се пребарува, ги држи вашите неодамнешни модели на врвот и за секој модел ја прикажува цената за 1M токени, контекстниот прозорец и ознаки за алатки, влез на слики, размислување и структуриран излез.

Разговорот

Одговорите се стримуваат во разговорот додека се пишуваат. Размислувањето на моделот е прикажано во посебен блок што можете да го соберете.
Под секој одговор: време до првиот токен, токени во секунда, поминато време, влезни и излезни токени со кешираните и деловите за размислување, проценка на трошокот на чекорот, причината за завршување и ид на одговорот.
Ваша порака може да се уреди и да се испрати повторно од таа точка. Одговорот може да се генерира повторно. Пораката може да се избрише, а бришењето може да се врати во рок од неколку секунди.
Стоп или копчето Esc го запира одговорот што се пишува.
Сликите се прикачуваат со копчето за слика, со лепење или со повлекување датотека, за модели што прифаќаат слики. Сликата се намалува на 1,568 пиксели по долгата страна пред да се испрати. Датотека над 30 MB се прескокнува.
Полето за пишување и system prompt-от прикажуваат број токени. За хостираните open-weight модели тоа е точниот број од POST /v1/tokenize. За другите модели е проценка, означена со ≈.
Неуспешното барање покажува што да направите потоа: поставете клуч кога клучот бил одбиен, дополнете кога салдото е потрошено, секунди за чекање по премногу барања, или повторен обид по грешка на серверот.

Поставки за барање

Копчето Поставки отвора панел со шест табулатори. Поставките припаѓаат на разговорот: секој разговор ги чува своите.

Табулатор	Што содржи
Систем	System prompt-от на разговорот, испратен со секое барање. Пет шаблони го пополнуваат, а се прикажува и неговиот број токени.
Параметри	Максимални излезни токени, температура, `top_p`, напор за размислување, секвенци за запирање, `seed` и прекинувачите за streaming и веб пребарување. Контрола за која избраниот ендпоинт нема поле е исклучена и означена.
Алатки	Дефиниции на алатки испратени со барањето: четири претходно поставени (`get_weather`, `read_file`, `run_shell`, `web_search`) или ваша сопствена дефиниција како JSON, и `tool_choice` (`auto`, `none`, `required` или една алатка по име). Кога моделот повикува алатка, разговорот го прикажува повикот со поле за резултатот. Со вклучено Понуди примерни резултати, еден клик пополнува примерен резултат. Можете да внесете и свој, па да го испратите за да го продолжите чекорот.
Структурирано	`response_format`: `text`, `json_object` или `json_schema` со име на schema и JSON schema. Со поставена schema, последниот одговор се проверува според неа и во разговорот се означува дали одговара или не. Табулаторот е исклучен на ендпоинтот Messages, а опција што избраниот модел не ја прима не се нуди.
Код	Барањето на тековниот разговор како cURL, Python, Node или Go код, изграден од разговорот и неговите поставки. Клучот се печати како `YOUR_API_KEY`. Кодот може да се копира или да се отвори во голем приказ.
Настани	Последниот чекор онака како што патувал по мрежата: секој настан на streaming со своето временско поместување и филтер, составениот одговор, header-ите на одговорот (`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 клуч	Во меморијата на отворениот таб. Залепениот клуч го нема кога страницата ќе се вчита повторно или табот ќе се затвори. Најавени, клучот се чита од вашата сметка секој пат.
Настани на streaming, header-и и барање од последниот чекор	Во отворената страница, додека не се вчита повторно.
Барања	Се испраќаат од вашиот прелистувач до API-то со вашиот клуч. Се бројат во вашето салдо како секое друго API барање.

Тастатура

Копчиња	Што прави
`Enter`	Испрати ја пораката.
`Shift` + `Enter`	Започни нов ред.
`Ctrl` + `K`	Отвори ја командната палета: смени ендпоинт или модел, постави system шаблон, започни нов разговор, вклучи/исклучи streaming, алатки или споредба. На Mac: ⌘ K.
`Esc`	Запри го одговорот што се пишува, или затвори отворен панел на тесен екран.