API Playground

Интерактив

Ҳар модел ва endpoint-ро дар браузер бо калиди худ санҷед — баромади streaming, инспектори дархост ва коди тавлидшуда, ки онро мустақиман ба барномаи худ гузошта метавонед.

Кушодани Playground

Playground консоли чат барои API дар /docs/playground аст. Шумо бо модел сӯҳбат мекунед ва playground ҳамон дархостҳоеро мефиристад, ки коди шумо мефиристод: ба яке аз се endpoint, бо модел, system prompt, параметрҳо ва абзорҳое, ки шумо муқаррар кардед. Ҳар дархостро ҳамчун код ва ҳамчун рӯйдодҳои хоми ҷараён хондан мумкин аст.

Оғоз

Калид диҳед — Бо воридшавӣ playground калиди API-и аккаунти шуморо истифода мебарад ва балансатонро нишон медиҳад. Бе воридшавӣ Илова кардани калид-ро интихоб кунед ва калидро гузоред: он танҳо дар ин варақа нигоҳ дошта мешавад ва ҳеҷ гоҳ захира намешавад.
Endpoint ва моделро интихоб кунед — Навори боло гузарандаи endpoint ва интихобкунаки моделро дорад. Гуфтугӯи нав дар Chat Completions бо shannon-3 оғоз мешавад.
Паём фиристед — Дар поён нависед ва Enter-ро пахш кунед. Ҳар ҷавоб ба гуфтугӯ ҳамроҳ мешавад, бинобар ин паёми навбатӣ онро идома медиҳад. Экрани холӣ се prompt-и оғозӣ ва мисоли омодаи даъвати абзорро пешниҳод мекунад.

Калидатонро дар саҳифаи Калидҳо ва истифода меёбед ва иваз мекунед. Калидҳо ва истифода

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-и ҷавоб.
Паёми шуморо таҳрир кардан ва аз ҳамон нуқта бори дигар фиристодан мумкин аст. Ҷавобро аз нав тавлид кардан мумкин аст. Паёмро нест кардан мумкин аст ва нест кардан чанд сония бекор карда мешавад.
Қатъ ё тугмаи Esc ҷавобе, ки навишта истодааст, тамом мекунад.
Тасвирҳо бо тугмаи тасвир, бо гузоштан ё бо партофтани файл барои моделҳое, ки тасвирро қабул мекунанд, замима карда мешаванд. Тасвир пеш аз фиристодан то 1,568 пиксел дар канори дарозаш тағйири андоза карда мешавад. Файли аз 30 MB зиёд ба назар гирифта намешавад.
Майдони навиштан ва system prompt шумораи токенҳоро нишон медиҳанд. Барои моделҳои open-weight-и хостшуда он ҳисоби дақиқ аз POST /v1/tokenize аст. Барои моделҳои дигар он арзёбӣ аст, ки бо ≈ нишон дода мешавад.
Дархости ноком нишон медиҳад, ки баъд чӣ кор кардан лозим: калид муқаррар кунед, вақте ки калид рад шуд, кредит пур кунед, вақте ки баланс тамом шуд, сонияҳои интизорӣ пас аз дархостҳои аз ҳад зиёд, ё такрор пас аз хатогии сервер.

Танзимоти дархост

Тугмаи Танзимот панелро бо шаш варақа мекушояд. Танзимот ба гуфтугӯ тааллуқ доранд: ҳар гуфтугӯ танзимоти худро нигоҳ медорад.

Варақа	Чиро нигоҳ медорад
System	System prompt-и гуфтугӯ, ки бо ҳар дархост фиристода мешавад. Панҷ қолаб онро пур мекунад ва шумораи токенҳои он нишон дода мешавад.
Параметрҳо	Ҳадди аксари токенҳои баромад, ҳарорат, `top_p`, сатҳи кӯшиши reasoning, пайдарпаии таваққуф, `seed` ва гузарандаҳо барои streaming ва ҷустуҷӯи веб. Идоракунии он, ки endpoint-и интихобшуда майдон надорад, хомӯш карда мешавад ва нишон дода мешавад.
Абзорҳо	Таърифҳои абзор, ки бо дархост фиристода мешаванд: чор пресет (`get_weather`, `read_file`, `run_shell`, `web_search`) ё таърифи худи шумо ҳамчун JSON ва `tool_choice` (`auto`, `none`, `required` ё як абзор бо ном). Вақте ки модел абзорро даъват мекунад, гуфтугӯ даъватро бо қуттӣ барои натиҷа нишон медиҳад. Бо фаъол будани Пешниҳоди натиҷаҳои намунавӣ як клик натиҷаи намунавиро пур мекунад. Шумо метавонед натиҷаи худро низ нависед ва баъд онро барои идомаи навбат фиристед.
Сохторӣ	`response_format`: `text`, `json_object` ё `json_schema` бо номи схема ва JSON schema. Бо схемаи муқарраршуда ҷавоби охирин бо он санҷида мешавад ва дар гуфтугӯ ҳамчун мувофиқ ё номувофиқ нишон дода мешавад. Варақа дар endpoint-и 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` гузаронида шудааст, бо сабаб боздошта мешавад.
Тасвирҳо	Вақте ки ба модели танҳо матнӣ мегузаред, аз паём бо ёддошт хориҷ карда мешаванд.

Муқоисаи ду модел

Муқоисаи ду модел дар менюи Бештар интихобкунаки дуюми моделро илова мекунад. Он гоҳ ҳар паём ба ҳарду модел ҳамзамон, бо ҳамон танзимот меравад ва ду ҷавоб паҳлӯи ҳам меистанд, бо нишонаи A ва B. Шумо метавонед як тарафро алоҳида аз нав тавлид кунед. Вақте ки як тараф абзорро даъват мекунад, натиҷае, ки мефиристед, танҳо ҳамон тарафро идома медиҳад.

Нусхаи пайванди мубодила гуфтугӯро ба худи пайванд, дар қисми баъд аз #, ҷойгир мекунад. Чизе бор карда намешавад. Тасвирҳо, калиди шумо ва тафсилоти иҷрои охирин хориҷ карда мешаванд. Ҳар кӣ пайвандро кушояд, гуфтугӯро ҳамчун гуфтугӯи нав дар playground-и худаш мегирад.
Гуфтугӯе, ки барои пайванд аз ҳад дароз аст, бо ёддошт рад карда мешавад. Ба ҷои он онро ҳамчун JSON боргирӣ кунед.
Боргирии JSON-и гуфтугӯ гуфтугӯро бо танзимоташ ҳамчун файл захира мекунад. Воридоти JSON дар панели гуфтугӯҳо чунин файлро мекушояд.
Нусха ҳамчун cURL дархости ҷориро ҳамчун як фармони cURL нусха мекунад.

Чӣ дар куҷо нигоҳ дошта мешавад

Чӣ	Дар куҷо нигоҳ дошта мешавад
Гуфтугӯҳо, абзорҳои захирашуда, моделҳои охирин, тарҳи панелҳо	Дар ин браузер. Онҳо ба Shannon фиристода намешаванд ва ба дастгоҳи дигар намераванд.
Калиди API	Дар хотираи варақаи кушода. Калиди гузошташуда ҳангоми аз нав бор шудани саҳифа ё баста шудани варақа аз байн меравад. Бо воридшавӣ калид ҳар дафъа аз аккаунти шумо хонда мешавад.
Рӯйдодҳои ҷараён, сарлавҳаҳо ва дархости навбати охирин	Дар саҳифаи кушода, то аз нав бор шуданаш.
Дархостҳо	Аз браузери шумо бо калиди шумо ба API фиристода мешаванд. Онҳо мисли ҳар дархости дигари API аз балансатон ҳисоб карда мешаванд.

Клавиатура

Тугмаҳо	Чӣ кор мекунад
`Enter`	Паёмро фиристед.
`Shift` + `Enter`	Хати нав оғоз кунед.
`Ctrl` + `K`	Палитраи фармонҳоро кушоед: endpoint ё моделро иваз кунед, қолаби system муқаррар кунед, гуфтугӯи нав оғоз кунед, streaming, абзорҳо ё муқоисаро фаъол/ғайрифаъол кунед. Дар Mac: ⌘ K.
`Esc`	Ҷавобе, ки навишта истодааст, қатъ кунед, ё дар экрани танг панели кушодаро пӯшед.