API Playground

Интерактивдүү

Ар бир модель менен endpoint'ти браузерде өз ачкычыңыз менен сынап көрүңүз — стриминг чыгыш, сурам инспектору жана түз эле колдонмоңузга чаптаса боло турган даяр код.

Playground'ду ачуу

Playground — /docs/playground дарегиндеги API үчүн чат консолу. Сиз модель менен сүйлөшөсүз, ал эми playground коддуңуз жөнөткөн сурамдарды жөнөтөт: үч endpoint'тин бирине, сиз койгон модель, системалык промпт, параметрлер жана куралдар менен. Ар бир сурамды код катары жана чийки стрим окуялары катары кайра окуса болот.

Баштоо

Ачкыч бериңиз — Кирген болсоңуз, playground аккаунтуңуздун API ачкычын колдонот жана балансыңызды көрсөтөт. Кирбесеңиз, Add key тандап, ачкычты чаптаңыз: ал ушул өтмөктө гана сакталат жана эч качан сакталбайт.
Endpoint жана модель тандаңыз — Жогорку тилкеде endpoint которгуч жана модель тандагыч бар. Жаңы сүйлөшүү Chat Completions'та shannon-3 менен башталат.
Билдирүү жөнөтүңүз — Төмөндө жазып, Enter басыңыз. Ар бир жооп сүйлөшүүгө кошулат, ошондуктан кийинки билдирүү аны улантат. Бош экран үч баштапкы промпт жана даяр курал чалуу мисалын сунуштайт.

Ачкычыңызды 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 токендин баасын, контекст терезесин жана куралдар, сүрөт кириши, reasoning жана структураланган чыгыш белгилерин көрсөтөт.

Сүйлөшүү

Жооптор жазылып жатканда сүйлөшүүгө стримделет. Модельдин reasoning'и өзүнчө блокто көрсөтүлөт, аны жыйса болот.
Ар бир жооптун астында: биринчи токенге чейинки убакыт, секундасына токен, өткөн убакыт, кэштелген жана reasoning бөлүктөрү менен кириш жана чыгыш токендери, кадамдын болжолдуу баасы, аяктоо себеби жана жооп id.
Сиздин билдирүүңүздү түзөтүп, ошол жерден кайра жөнөтсө болот. Жоопту кайра түзсө болот. Билдирүүнү өчүрсө болот жана өчүрүүнү бир нече секунд ичинде кайтарса болот.
Stop же Esc баскычы жазылып жаткан жоопту токтотот.
Сүрөттөр сүрөт кабыл алган моделдер үчүн сүрөт баскычы менен, чаптоо менен же файлды таштоо менен тиркелет. Сүрөт жөнөтүлгөнгө чейин узун четинде 1,568 пикселге чейин кичирейтилет. 30 MB'ден чоң файл өткөрүлүп жиберилет.
Жазуу талаасы жана системалык промпт токен санын көрсөтөт. Хостингдеги ачык салмактуу моделдер үчүн бул POST /v1/tokenize берген так сан. Башка моделдер үчүн бул ≈ менен белгиленген болжол.
Ишке ашпаган сурам кийин эмне кылууну көрсөтөт: ачкыч четке кагылганда ачкыч коюу, баланс түгөнгөндө толуктоо, өтө көп сурамдан кийин күтө турган секунддар, же сервер катасынан кийин кайра аракет.

Сурам жөндөөлөрү

Settings баскычы алты өтмөгү бар панелди ачат. Жөндөөлөр сүйлөшүүгө таандык: ар бир сүйлөшүү өзүнүкүн сактайт.

Өтмөк	Эмнени камтыйт
Система	Сүйлөшүүнүн системалык промпту, ар бир сурам менен жөнөтүлөт. Аны беш шаблон толтурат жана анын токен саны көрсөтүлөт.
Параметрлер	Максималдуу чыгыш токендери, температура, `top_p`, reasoning аракети, токтотуу ырааттуулуктары, `seed` жана стриминг менен веб издөөнүн которгучтары. Тандалган endpoint'те талаасы жок башкаруу өчүрүлүп, белгиленет.
Куралдар	Сурам менен жөнөтүлгөн курал аныктамалары: төрт даяр жөндөө (`get_weather`, `read_file`, `run_shell`, `web_search`) же JSON түрүндөгү өз аныктамаңыз, жана `tool_choice` (`auto`, `none`, `required` же аты боюнча бир курал). Модель куралды чакырганда, сүйлөшүү чалууну натыйжа үчүн кутуча менен көрсөтөт. Offer sample results күйгөндө бир чычкан басуу үлгү натыйжаны толтурат. Өзүңүздүкүн да жазып, андан кийин кадамды улантуу үчүн жөнөтсөңүз болот.
Структураланган	`response_format`: `text`, `json_object` же схема аты жана JSON схемасы менен `json_schema`. Схема коюлганда акыркы жооп ага каршы текшерилип, ал шайкеш келеби же жокпу, сүйлөшүүдө белгиленет. Өтмөк Messages endpoint'inde өчүрүлгөн, ал эми тандалган модель кабыл албаган опция сунушталбайт.
Код	Учурдагы сүйлөшүүнүн сурамы 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 менюсундагы 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`	Командалар палитрасын ачуу: endpoint же моделди которуу, системалык шаблон коюу, жаңы сүйлөшүү баштоо, стримингди, куралдарды же салыштырууну күйгүзүү/өчүрүү. Mac'те: ⌘ K.
`Esc`	Жазылып жаткан жоопту токтотуу же тар экранда ачык панелди жабуу.