API Playground

Интерактив

Өөрийн түлхүүрээр загвар, endpoint бүрийг хөтөч дээр туршаарай — streaming гаралт, хүсэлт шалгагч болон аппдаа шууд буулгаж болох үүсгэсэн код.

Playground нээх

Playground нь /docs/playground дээрх API-ийн чат консол. Та загвартай ярилцахад playground таны кодын илгээх хүсэлтийг яг ижлээр, таны тохируулсан загвар, system prompt, параметр, tool-тойгоор гурван endpoint-ийн нэгэнд илгээнэ. Хүсэлт бүрийг код болон түүхий stream event хэлбэрээр буцааж унших боломжтой.

Эхлэх

Түлхүүр өгөх — Нэвтэрсэн үед playground таны бүртгэлийн API түлхүүрийг ашиглаж, үлдэгдлийг харуулна. Нэвтрээгүй бол Add key-г сонгож түлхүүрээ буулгана уу: түлхүүр зөвхөн энэ табд хадгалагдах бөгөөд хэзээ ч хадгалагдахгүй.
Endpoint ба загвар сонгох — Дээд мөр endpoint сэлгүүр ба загвар сонгогчийг агуулна. Шинэ харилцан яриа Chat Completions дээр shannon-3-аар эхэлнэ.
Мессеж илгээх — Доор бичээд Enter дарна уу. Хариу бүр харилцан ярианд нэмэгддэг тул дараагийн мессеж үүнийг үргэлжлүүлнэ. Хоосон дэлгэц гурван эхлэх prompt ба бэлэн tool дуудлагын жишээг санал болгоно.

Түлхүүрээ 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 токены үнэ, контекст цонх, мөн tool, зургийн оролт, reasoning, бүтэцтэй гаралтын тэмдгийг харуулна.

Харилцан яриа

Хариулт бичигдэх тусам харилцан яриа руу stream хийгдэнэ. Загварын reasoning-ийг нугалж болох тусдаа блокт харуулна.
Хариу бүрийн доор: эхний токен хүртэлх хугацаа, секундэд токен, нийт хугацаа, кэшлэгдсэн ба reasoning хэсэгтэй оролт, гаралтын токен, ээлжийн зардлын тооцоо, finish reason ба хариуны id.
Таны мессежийг засаж, тэр цэгээс дахин илгээж болно. Хариуг дахин үүсгэж болно. Мессежийг устгаж болох бөгөөд устгалыг хэдэн секундын турш буцааж болно.
Stop эсвэл Esc товч бичигдэж буй хариуг зогсооно.
Зураг авдаг загварт зургийг зургийн товч, буулгах эсвэл файл чирэх аргаар хавсаргана. Зургийг илгээхээс өмнө урт ирмэг нь 1,568 пиксел болтол багасгана. 30 MB-ээс том файлыг алгасна.
Composer ба system prompt токены тоог харуулна. Hosted open-weight загварт энэ нь POST /v1/tokenize-ийн яг тоо. Бусад загварт ойролцоо тооцоо бөгөөд ≈-ээр тэмдэглэнэ.
Амжилтгүй хүсэлт дараа нь юу хийхийг харуулна: түлхүүр татгалзагдсан бол түлхүүр тохируулах, үлдэгдэл дууссан бол цэнэглэх, хэт олон хүсэлтийн дараа хүлээх секунд, эсвэл серверийн алдааны дараа дахин оролдох.

Хүсэлтийн тохиргоо

Settings товч зургаан табтай самбар нээнэ. Тохиргоо харилцан ярианд хамаарна: харилцан яриа бүр өөрийнхөө тохиргоог хадгална.

Табын нэр	Юу агуулдаг
System	Харилцан ярианы system prompt, хүсэлт бүртэй хамт илгээгдэнэ. Таван template үүнийг бөглөх бөгөөд токены тоог харуулна.
Параметрүүд	Гаралтын дээд токен, temperature, `top_p`, reasoning effort, зогсоох дараалал, `seed`, мөн streaming ба вэб хайлтын унтраалга. Сонгосон endpoint-д талбар нь байхгүй хяналтыг унтрааж тэмдэглэнэ.
Tools	Хүсэлттэй хамт илгээх tool тодорхойлолт: дөрвөн бэлэн загвар (`get_weather`, `read_file`, `run_shell`, `web_search`) эсвэл JSON хэлбэрийн өөрийн тодорхойлолт, мөн `tool_choice` (`auto`, `none`, `required` эсвэл нэрээр нь нэг tool). Загвар tool дуудахад харилцан яриан дээр дуудлага үр дүнгийн нүдтэй харагдана. Offer sample results асаалттай үед нэг товшилтоор жишээ үр дүн бөглөгдөнө. Өөрийнхөө үр дүнг бичээд илгээж ээлжийг үргэлжлүүлж болно.
Бүтэцтэй	`response_format`: `text`, `json_object`, эсвэл schema-ийн нэр ба JSON schema-тай `json_schema`. Schema тогтоосон үед сүүлийн хариултыг түүнтэй тулган шалгаж, тохирсон эсэхийг харилцан яриан дээр тэмдэглэнэ. Messages endpoint дээр таб унтраастай, сонгосон загварын авдаггүй сонголтыг санал болгохгүй.
Код	Одоогийн харилцан ярианы хүсэлтийг харилцан яриа ба түүний тохиргоонаас бүтээсэн cURL, Python, Node эсвэл Go кодоор. Түлхүүрийг `YOUR_API_KEY` гэж хэвлэнэ. Кодыг хуулах эсвэл том харагдацад нээж болно.
Event-үүд	Сүүлийн ээлж сүлжээгээр яг хэрхэн явсан бэ: stream event бүр цагийн шилжилт ба шүүлтүүртэй, угсарсан хариу, хариуны header (`x-request-id`, `content-type`, `retry-after`, `date`) ба хүсэлтийн body. Эдгээр хуудас дахин ачаалтал хадгалагдана.

Оролтын шалгалт

Таны бичсэн утгыг хүсэлт илгээхээс өмнө шалгана. Мужаас гарсан утгыг талбар дээр нь тэмдэглэж, засах хүртэл илгээхийг зогсооно.

Тохиргоо	Шалгалт
Гаралтын дээд токен	1-ээс загварын `max_output_tokens` хүртэлх бүхэл тоо.
Temperature	0-ээс 2 хүртэлх тоо. Хоосон бол талбарыг хүсэлтээс хасна.
`top_p`	0-ээс 1 хүртэлх тоо. Хоосон бол талбарыг хүсэлтээс хасна.
`seed`	Бүхэл тоо.
Зогсоох дараалал	Дээд тал нь 4, таслалаар тусгаарлана.
`response_format`	Сонгосон загварын авдаг төрөл байх ёстой. `json_schema`-гүй эсвэл `response_format`-гүй загварт шилжүүлсэн харилцан яриаг шалтгааныг нь хэлээд зогсооно.
Зураг	Зөвхөн текст авдаг загварт шилжихэд тэмдэглэлтэйгээр мессежээс хасагдана.

Хоёр загвар харьцуулах

More цэсний Compare two models хоёр дахь загвар сонгогч нэмнэ. Дараа нь мессеж бүр хоёр загварт нэгэн зэрэг, ижил тохиргоотой очиж, хоёр хариулт A, B гэж тэмдэглэгдэн зэрэгцэн харагдана. Нэг талыг дангаар дахин үүсгэж болно. Нэг тал tool дуудахад таны илгээсэн үр дүн зөвхөн тэр талыг үргэлжлүүлнэ.

Copy share link харилцан яриаг линк дотор нь, #-ийн дараах хэсэгт багцална. Юу ч upload хийгдэхгүй. Зураг, таны түлхүүр, сүүлийн ажиллуулалтын дэлгэрэнгүйг оруулахгүй. Линкийг нээсэн хүн харилцан яриаг өөрийн playground-д шинэ харилцан яриа болгон авна.
Линкэнд багтахааргүй урт харилцан яриаг тэмдэглэлтэйгээр татгалзана. Үүний оронд JSON болгон татаж авна уу.
Download conversation JSON харилцан яриаг тохиргоотой нь файл болгон хадгална. Харилцан ярианы самбар дахь Import JSON ийм файлыг нээнэ.
Copy as cURL одоогийн хүсэлтийг нэг cURL тушаал болгон хуулна.

Юу хаана хадгалагдах

Юу	Хаана хадгалагдах
Харилцан яриа, хадгалсан tool, сүүлийн загварууд, самбарын байршил	Энэ хөтөч дотор. Shannon руу илгээгдэхгүй бөгөөд өөр төхөөрөмж рүү дагаж очихгүй.
API түлхүүр	Нээлттэй табын санах ойд. Буулгасан түлхүүр хуудас дахин ачаалах эсвэл таб хаагдахад алга болно. Нэвтэрсэн үед түлхүүрийг бүртгэлээс тухай бүрд уншина.
Сүүлийн ээлжийн stream event, header ба хүсэлт	Нээлттэй хуудас дотор, дахин ачаалтал.
Хүсэлтүүд	Таны хөтөчөөс таны түлхүүрээр API руу илгээгдэнэ. Бусад API хүсэлтийн адил үлдэгдлээс тооцогдоно.

Гар

Товчууд	Юу хийдэг
`Enter`	Мессежийг илгээнэ.
`Shift` + `Enter`	Шинэ мөр эхлүүлнэ.
`Ctrl` + `K`	Command palette нээнэ: endpoint эсвэл загвар солих, system template тогтоох, шинэ харилцан яриа эхлүүлэх, streaming, tools эсвэл compare-ийг асаах/унтраах. Mac дээр: ⌘ K.
`Esc`	Бичигдэж буй хариуг зогсооно, эсвэл нарийн дэлгэц дээр нээлттэй самбарыг хаана.