API Playground

Интерактив

Әр модель мен endpoint-ті браузерде өз кілтіңізбен байқаңыз — streaming шығыс, сұрау инспекторы және қолданбаңызға тікелей қоюға болатын жасалған код.

Playground-ты іске қосу

Playground — /docs/playground бетіндегі API-ге арналған чат консолі. Сіз модельмен сөйлесесіз, ал playground кодыңыз жіберетін сұрауларды жібереді: үш endpoint-тің біріне, орнатқан модельмен, system prompt-пен, параметрлермен және құралдармен. Әр сұрауды код ретінде және шикі стрим оқиғалары ретінде қайта оқуға болады.

Бастау

Оған кілт беріңіз — Жүйеге кіргенде playground аккаунтыңыздың API кілтін қолданып, балансыңызды көрсетеді. Кірмегенде Кілт қосу таңдап, кілтті қойыңыз: ол тек осы қойындыда сақталады және ешқашан бекітілмейді.
Endpoint пен модельді таңдаңыз — Жоғарғы жолақта endpoint қосқышы және модель таңдағышы бар. Жаңа сөйлесу shannon-3 моделімен Chat Completions бойынша басталады.
Хабарлама жіберіңіз — Төменге жазып, Enter басыңыз. Әр жауап сөйлесуге қосылады, сондықтан келесі хабарлама оны жалғастырады. Бос экран үш бастапқы промптты және дайын құрал шақыру мысалын ұсынады.

Кілтіңізді Keys & usage бетінде табасыз және ауыстырасыз. Keys & usage

Endpoint-тер және модельдер

Endpoint қосқышы playground қай сұрау форматын құрастыратынын шешеді. Оны сөйлесудің ортасында өзгертуге болады; хабарламалар қалады.

Endpoint	Жіберетін сұрауы	Анықтамалық
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-тан асатын файл өткізіледі.
Хабарлама өрісі мен system prompt токен санын көрсетеді. Hosted open-weight модельдер үшін ол POST /v1/tokenize дәл саны. Басқа модельдер үшін ол ≈ белгісі бар бағалау.
Сәтсіз сұрау келесіде не істеу керегін көрсетеді: кілт қабылданбағанда кілт орнату, баланс таусылғанда толықтыру, тым көп сұраудан кейін күту секундтары, немесе сервер қатесінен кейін қайталау.

Сұрау параметрлері

Settings түймесі алты қойындысы бар панельді ашады. Параметрлер сөйлесуге тиесілі: әр сөйлесу өз параметрлерін сақтайды.

Қойынды	Нені сақтайды
Жүйе	Сөйлесудің әр сұраумен жіберілетін system prompt-ы. Оны бес үлгі толтырады, ал оның токен саны көрсетіледі.
Параметрлер	Ең көп шығыс токені, температура, `top_p`, пайымдау күші, тоқтату тізбектері, `seed` және streaming мен веб іздеу қосқыштары. Таңдалған endpoint-те өрісі жоқ басқару элементі өшіріліп, белгіленеді.
Құралдар	Сұраумен жіберілетін құрал анықтамалары: төрт дайын үлгі (`get_weather`, `read_file`, `run_shell`, `web_search`) немесе өз анықтамаңыз JSON түрінде, және `tool_choice` (`auto`, `none`, `required` немесе аты бойынша бір құрал). Модель құралды шақырғанда тізбекте шақыру нәтиже жолағымен көрсетіледі. Үлгі нәтижелерін ұсыну қосулы болса, бір басу үлгі нәтижені толтырады. Өзіңіздікін де тере аласыз, содан кейін кезеңді жалғастыру үшін жібересіз.
Құрылымдық	`response_format`: `text`, `json_object` немесе схема аты мен JSON схемасы бар `json_schema`. Схема орнатылғанда соңғы жауап оған қарсы тексеріліп, тізбекте сәйкес не сәйкес емес деп белгіленеді. Қойынды Messages endpoint-інде өшірулі, ал таңдалған модель қабылдамайтын нұсқа ұсынылмайды.
Код	Ағымдағы сөйлесудің сұрауы 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` жоқ модельге ауыстырылған сөйлесу себебі көрсетіліп тоқтатылады.
Суреттер	Тек мәтін қабылдайтын модельге ауысқанда хабарламадан ескертпемен алынып тасталады.

Екі модельді салыстыру

More мәзіріндегі Екі модельді салыстыру екінші модель таңдағышын қосады. Содан кейін әр хабарлама екі модельге бір мезгілде, бірдей параметрлермен барады, ал екі жауап қатар тұрады, A және B деп белгіленген. Бір жағын жеке қайта жасауға болады. Бір жақ құралды шақырғанда жіберетін нәтижеңіз тек сол жақты жалғастырады.

Бөлісу сілтемесін көшіру сөйлесуді сілтеменің өзіне, # кейінгі бөлікке, жинайды. Ештеңе жүктелмейді. Суреттер, кілтіңіз және соңғы іске қосудың мәліметтері алынып тасталады. Сілтемені ашқан адам сөйлесуді өз playground-ында жаңа сөйлесу ретінде алады.
Сілтемеге сыймайтын ұзын сөйлесуден ескертпемен бас тартылады. Оның орнына оны JSON ретінде жүктеңіз.
Сөйлесу JSON-ін жүктеу сөйлесуді параметрлерімен файл ретінде сақтайды. Сөйлесулер панеліндегі JSON-ды импорттау мұндай файлды ашады.
cURL ретінде көшіру ағымдағы сұрауды бір cURL пәрмені ретінде көшіреді.

Не қайда сақталады

Не	Қайда сақталады
Сөйлесулер, сақталған құралдар, соңғы модельдер, панель орналасуы	Осы браузерде. Олар Shannon-ға жіберілмейді және басқа құрылғыға ілеспейді.
API кілті	Ашық қойындының жадында. Қойылған кілт бет қайта жүктелгенде немесе қойынды жабылғанда жоғалады. Кіргенде кілт әр рет аккаунтыңыздан оқылады.
Соңғы кезеңнің стрим оқиғалары, тақырыптары және сұрауы	Ашық бетте, ол қайта жүктелгенше.
Сұраулар	Браузеріңізден API-ге кілтіңізбен жіберіледі. Олар кез келген басқа API сұрауы сияқты балансыңыздан есептеледі.

Пернетақта

Пернелер	Не істейді
`Enter`	Хабарламаны жіберу.
`Shift` + `Enter`	Жаңа жолды бастау.
`Ctrl` + `K`	Пәрмендер палитрасын ашу: endpoint немесе модельді ауыстыру, system үлгісін орнату, жаңа сөйлесуді бастау, streaming, құралдарды немесе салыстыруды қосу-өшіру. Mac-та: ⌘ K.
`Esc`	Жазылып жатқан жауапты тоқтату, немесе тар экранда ашық панельді жабу.