API Playground
InteraktivHar bir model va endpointni brauzerda o'z kalitingiz bilan sinab ko'ring — streaming chiqish, so'rov inspektori va to'g'ridan-to'g'ri ilovangizga qo'yish mumkin bo'lgan yaratilgan kod.
Playground — /docs/playground dagi API uchun chat konsoli. Siz model bilan gaplashasiz, playground esa kodingiz yuboradigan so'rovlarning o'zini yuboradi: uchta endpointdan biriga, siz belgilagan model, system prompt, parametrlar va tool'lar bilan. Har bir so'rovni kod va xom oqim hodisalari sifatida qayta o'qish mumkin.
Boshlash
- Unga kalit bering — Tizimga kirgan holda playground hisobingizning API kalitidan foydalanadi va balansingizni ko'rsatadi. Tizimga kirmagan bo'lsangiz, Add keyni tanlang va kalitni qo'ying: u faqat shu yorliqda saqlanadi va hech qachon saqlanib qolmaydi.
- Endpoint va modelni tanlang — Yuqori panelda endpoint almashtirgich va model tanlagich bor. Yangi suhbat Chat Completions'da
shannon-3bilan boshlanadi. - Xabar yuboring — Pastga yozing va Enter bosing. Har bir javob suhbatga qo'shiladi, shuning uchun keyingi xabar uni davom ettiradi. Bo'sh ekran uchta boshlang'ich prompt va tayyor tool chaqiruvi namunasini taklif qiladi.
Kalitingizni Keys & usage sahifasida topasiz va almashtirasiz. Keys & usage
Endpointlar va modellar
Endpoint almashtirgich playground qaysi so'rov formatini yasashini belgilaydi. Uni suhbat o'rtasida o'zgartirish mumkin; xabarlar qoladi.
| Endpoint | Yuboradigan so'rovi | Ma'lumotnoma |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Anthropic formati |
Model tanlagich GET /v1/models qaytaradigan narsani sanab chiqadi. Unda qidirish mumkin, so'nggi modellaringizni tepada saqlaydi va har bir model uchun 1M token narxi, kontekst oynasi hamda tool'lar, rasm kirishi, mulohaza va tuzilmali chiqish belgilarini ko'rsatadi.
Suhbat
- Javoblar yozilayotgan paytda suhbatga oqib keladi. Modelning mulohazasi o'zining alohida blokida ko'rsatiladi, uni yig'ish mumkin.
- Har bir javob ostida: birinchi tokengacha vaqt, soniyasiga tokenlar, o'tgan vaqt, keshdagi va mulohaza qismlari bilan kirish va chiqish tokenlari, navbat narxining bahosi, tugash sababi va javob id'si.
- Xabaringizni tahrirlab, o'sha nuqtadan qayta yuborish mumkin. Javobni qayta yaratish mumkin. Xabarni o'chirish mumkin va o'chirishni bir necha soniya ichida bekor qilish mumkin.
- Stop yoki Esc tugmasi yozilayotgan javobni tugatadi.
- Rasmlar rasm qabul qiladigan modellar uchun rasm tugmasi bilan, qo'yish yoki faylni tashlash orqali biriktiriladi. Rasm yuborilishidan oldin uzun tomoni 1,568 pikselgacha kichraytiriladi. 30 MB dan katta fayl o'tkazib yuboriladi.
- Composer va system prompt token sonini ko'rsatadi. Xostingdagi open-weight modellar uchun bu
POST /v1/tokenizedan aniq son. Boshqa modellar uchun bu baho,≈bilan belgilanadi. - Muvaffaqiyatsiz so'rov keyingi qadamni ko'rsatadi: kalit rad etilganda kalitni o'rnatish, balans tugaganda to'ldirish, juda ko'p so'rovdan keyin kutiladigan soniyalar yoki server xatosidan keyin qayta urinish.
So'rov sozlamalari
Settings tugmasi oltita yorliqli panelni ochadi. Sozlamalar suhbatga tegishli: har bir suhbat o'zinikini saqlaydi.
| Yorliq | Nimani saqlaydi |
|---|---|
| System | Suhbatning system prompti, har bir so'rov bilan yuboriladi. Uni beshta shablon to'ldiradi va uning token soni ko'rsatiladi. |
| Parametrlar | Maks. chiqish tokenlari, temperatura, top_p, mulohaza darajasi, to'xtash ketma-ketliklari, seed hamda streaming va veb-qidiruv kalitlari. Tanlangan endpointda maydoni yo'q boshqaruv o'chirilgan va belgilangan bo'ladi. |
| Tool'lar | So'rov bilan yuboriladigan tool ta'riflari: to'rtta tayyor sozlama (get_weather, read_file, run_shell, web_search) yoki JSON sifatida o'z ta'rifingiz, hamda tool_choice (auto, none, required yoki nomi bilan bitta tool). Model tool chaqirganda suhbat chaqiruvni natija uchun katak bilan ko'rsatadi. Offer sample results yoqilgan bo'lsa, bir bosish namunaviy natijani to'ldiradi. O'zingiznikini ham yozib, navbatni davom ettirish uchun yuborishingiz mumkin. |
| Tuzilmali | response_format: text, json_object yoki sxema nomi va JSON sxemasi bilan json_schema. Sxema o'rnatilganda oxirgi javob unga qarshi tekshiriladi va suhbatda mos yoki mos emas deb belgilanadi. Yorliq Messages endpointida o'chirilgan, tanlangan model qabul qilmaydigan variant taklif etilmaydi. |
| Kod | Joriy suhbat so'rovi cURL, Python, Node yoki Go kodi sifatida, suhbat va uning sozlamalaridan yasalgan. Kalit YOUR_API_KEY sifatida chop etiladi. Kodni nusxalash yoki katta ko'rinishda ochish mumkin. |
| Hodisalar | Oxirgi navbat tarmoq orqali o'tganidek: har bir oqim hodisasi vaqt siljishi va filtr bilan, yig'ilgan javob, javob sarlavhalari (x-request-id, content-type, retry-after, date) va so'rov tanasi. Ular sahifa qayta yuklanguncha saqlanadi. |
Kirish tekshiruvlari
Kiritgan qiymatlaringiz so'rov yuborilishidan oldin tekshiriladi. Oraliqdan tashqaridagi qiymat o'z maydonida belgilanadi va to'g'rilanmaguncha yuborish to'xtatib turiladi.
| Sozlama | Tekshiruv |
|---|---|
| Maks. chiqish tokenlari | 1 dan modelning max_output_tokensigacha butun son. |
| Temperatura | 0 dan 2 gacha son. Bo'sh qoldirilsa, maydon so'rovdan chiqarib tashlanadi. |
top_p | 0 dan 1 gacha son. Bo'sh qoldirilsa, maydon so'rovdan chiqarib tashlanadi. |
seed | Butun son. |
| To'xtash ketma-ketliklari | Ko'pi bilan 4 ta, vergul bilan ajratilgan. |
response_format | Tanlangan model qabul qiladigan bo'lishi kerak. json_schemasiz yoki response_formatsiz modelga o'tkazilgan suhbat sabab ko'rsatilgan holda to'xtatib turiladi. |
| Rasmlar | Faqat matn qabul qiladigan modelga o'tganingizda izoh bilan xabardan olib tashlanadi. |
Ikki modelni solishtirish
More menyusidagi Compare two models ikkinchi model tanlagichni qo'shadi. Shunda har bir xabar bir xil sozlamalar bilan bir vaqtning o'zida ikkala modelga boradi va ikkita javob A va B deb belgilanib, yonma-yon turadi. Bir tomonni alohida qayta yaratish mumkin. Bir tomon tool chaqirganda siz yuborgan natija faqat o'sha tomonni davom ettiradi.
Ulashish, eksport va import
- Copy share link suhbatni havolaning o'ziga,
#dan keyingi qismga joylaydi. Hech narsa yuklanmaydi. Rasmlar, kalitingiz va oxirgi ishga tushirish tafsilotlari qoldiriladi. Havolani ochgan kishi suhbatni o'z playground'ida yangi suhbat sifatida oladi. - Havola uchun juda uzun suhbat izoh bilan rad etiladi. Uning o'rniga JSON sifatida yuklab oling.
- Download conversation JSON suhbatni sozlamalari bilan fayl sifatida saqlaydi. Suhbatlar panelidagi Import JSON bunday faylni ochadi.
- Copy as cURL joriy so'rovni bitta cURL buyrug'i sifatida nusxalaydi.
Nima qayerda saqlanadi
| Nima | Qayerda saqlanadi |
|---|---|
| Suhbatlar, saqlangan tool'lar, so'nggi modellar, panel joylashuvi | Shu brauzerda. Ular Shannon'ga yuborilmaydi va boshqa qurilmaga ergashmaydi. |
| API kalit | Ochiq yorliq xotirasida. Qo'yilgan kalit sahifa qayta yuklanganda yoki yorliq yopilganda yo'qoladi. Tizimga kirgan holda kalit har safar hisobingizdan o'qiladi. |
| Oxirgi navbatning oqim hodisalari, sarlavhalari va so'rovi | Ochiq sahifada, u qayta yuklanguncha. |
| So'rovlar | Brauzeringizdan API'ga kalitingiz bilan yuboriladi. Ular boshqa har qanday API so'rovi kabi balansingizga hisoblanadi. |
Klaviatura
| Tugmalar | Nima qiladi |
|---|---|
Enter | Xabarni yuborish. |
Shift + Enter | Yangi qator boshlash. |
Ctrl + K | Buyruqlar panelini ochish: endpoint yoki modelni almashtirish, system shablonini o'rnatish, yangi suhbat boshlash, streaming, tool'lar yoki solishtirishni yoqish-o'chirish. Mac'da: ⌘ K. |
Esc | Yozilayotgan javobni to'xtatish yoki tor ekranda ochiq panelni yopish. |