Məzmuna keç
API oyun meydanı

API oyun meydanı

İnteraktiv

Hər modeli və endpoint-i brauzerdə öz açarınızla sınayın — streaming çıxış, sorğu inspektoru və birbaşa tətbiqinizə yapışdıra biləcəyiniz yaradılmış kod.

Playground-u işə sal

Playground /docs/playground ünvanında API üçün çat konsoludur. Siz modellə danışırsınız, playground isə kodunuzun göndərəcəyi eyni sorğuları göndərir: üç endpoint-dən birinə, sizin təyin etdiyiniz model, system prompt, parametrlər və alətlərlə. Hər sorğunu kod və xam axın hadisələri kimi geri oxumaq olar.

Başlanğıc

  • Ona açar verin — Daxil olduqda playground hesabınızın API açarından istifadə edir və balansınızı göstərir. Daxil olmadıqda Add key seçin və açarı yapışdırın: o, yalnız bu tabda saxlanılır və heç vaxt yadda saxlanılmır.
  • Endpoint və model seçin — Yuxarı panel endpoint açarını və model seçicisini saxlayır. Yeni söhbət Chat Completions-da shannon-3 ilə başlayır.
  • Mesaj göndərin — Aşağıya yazın və Enter düyməsini sıxın. Hər cavab söhbətə qoşulur, beləcə növbəti mesaj onu davam etdirir. Boş ekran üç başlanğıc prompt və hazır alət çağırışı nümunəsi təklif edir.

Açarınızı Keys & usage səhifəsində tapıb yeniləyə bilərsiniz. Keys & usage

Endpoint-lər və modellər

Endpoint açarı playground-un hansı sorğu formatını quracağını müəyyən edir. Onu söhbətin ortasında dəyişə bilərsiniz; mesajlar qalır.

Endpoint Göndərdiyi sorğu İstinad
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic

Model seçicisi GET /v1/models-in qaytardığını siyahıya alır. Onda axtarış etmək olar, son modellərinizi yuxarıda saxlayır və hər model üçün 1M token qiymətini, kontekst pəncərəsini, alətlər, təsvir girişi, reasoning və strukturlu çıxış üçün işarələri göstərir.

Söhbət

  • Cavablar yazıldıqca söhbətə axır. Modelin reasoning-i ayrıca blokda göstərilir və onu yığa bilərsiniz.
  • Hər cavabın altında: ilk tokenə qədər vaxt, saniyədə token, keçən vaxt, keşlənmiş və reasoning hissələri ilə giriş və çıxış tokenləri, növbənin dəyərinin təxmini, bitmə səbəbi və cavab id-si.
  • Mesajınızı redaktə edib həmin nöqtədən yenidən göndərmək olar. Cavabı regenerasiya etmək olar. Mesajı silmək olar və silməni bir neçə saniyə ərzində geri qaytarmaq olar.
  • Stop və ya Esc düyməsi yazılmaqda olan cavabı bitirir.
  • Təsvirlər təsvir qəbul edən modellər üçün təsvir düyməsi ilə, yapışdırmaqla və ya faylı buraxmaqla əlavə olunur. Təsvir göndərilməzdən əvvəl uzun tərəfi 1,568 piksel olacaq şəkildə kiçildilir. 30 MB-dan böyük fayl atlanır.
  • Composer və system prompt token sayını göstərir. Host edilən açıq çəkili modellər üçün bu, POST /v1/tokenize-dan dəqiq saydır. Digər modellər üçün ≈ ilə işarələnmiş təxminidir.
  • Uğursuz sorğu sonra nə edəcəyinizi göstərir: açar rədd edildikdə açar təyin edin, balans bitdikdə artırın, çox sorğudan sonra gözləmə saniyələri və ya server xətasından sonra təkrar cəhd.

Sorğu parametrləri

Settings düyməsi altı tablı panel açır. Parametrlər söhbətə aiddir: hər söhbət öz parametrlərini saxlayır.

Tab Nəyi saxlayır
System Söhbətin system prompt-u, hər sorğu ilə göndərilir. Beş şablon onu doldurur və onun token sayı göstərilir.
Parametrlər Maksimum çıxış tokenləri, temperature, top_p, reasoning effort, dayanma ardıcıllıqları, seed və streaming ilə veb axtarışı üçün açarlar. Seçilmiş endpoint-də sahəsi olmayan idarəetmə söndürülür və qeyd olunur.
Alətlər Sorğu ilə göndərilən alət tərifləri: dörd hazır şablon (get_weather, read_file, run_shell, web_search) və ya JSON kimi öz tərifiniz və tool_choice (auto, none, required və ya ada görə bir alət). Model alət çağırdıqda söhbət çağırışı nəticə üçün qutu ilə göstərir. Offer sample results açıq olduqda bir kliklə nümunə nəticə doldurulur. Öz nəticənizi də yaza, sonra növbəni davam etdirmək üçün göndərə bilərsiniz.
Strukturlu response_format: text, json_object və ya sxem adı və JSON sxemi ilə json_schema. Sxem təyin edildikdə son cavab ona qarşı yoxlanılır və söhbətdə uyğun gəldiyi və ya gəlmədiyi qeyd olunur. Tab Messages endpoint-ində söndürülür və seçilmiş modelin qəbul etmədiyi seçim təklif olunmur.
Kod Cari söhbətin sorğusu cURL, Python, Node və ya Go kodu kimi, söhbətdən və parametrlərindən qurulur. Açar YOUR_API_KEY kimi çap olunur. Kodu kopyalamaq və ya böyük görünüşdə açmaq olar.
Hadisələr Son növbə şəbəkədən keçdiyi kimi: vaxt ofseti və filtrlə hər axın hadisəsi, yığılmış cavab, cavab başlıqları (x-request-id, content-type, retry-after, date) və sorğu gövdəsi. Bunlar səhifə yenidən yüklənənə qədər saxlanılır.

Giriş yoxlamaları

Yazdığınız dəyərlər sorğu göndərilməzdən əvvəl yoxlanılır. Aralıqdan kənar dəyər öz sahəsində qeyd olunur və düzəldilənə qədər göndərmə saxlanılır.

Parametr Yoxlama
Maksimum çıxış tokenləri 1-dən modelin max_output_tokens dəyərinə qədər tam ədəd.
Temperature 0-dan 2-yə qədər ədəd. Boş buraxılsa, sahə sorğudan çıxarılır.
top_p 0-dan 1-ə qədər ədəd. Boş buraxılsa, sahə sorğudan çıxarılır.
seed Tam ədəd.
Dayanma ardıcıllıqları Ən çoxu 4, vergüllə ayrılmış.
response_format Seçilmiş modelin qəbul etdiyi biri olmalıdır. json_schema-sı və ya response_format-ı olmayan modelə keçirilən söhbət səbəb göstərilərək saxlanılır.
Təsvirlər Yalnız mətn qəbul edən modelə keçdiyiniz zaman qeydlə birlikdə mesajdan çıxarılır.

İki modeli müqayisə edin

More menyusundakı Compare two models ikinci model seçicisi əlavə edir. Bundan sonra hər mesaj eyni anda, eyni parametrlərlə hər iki modelə gedir və iki cavab A və B işarəsi ilə yan-yana durur. Bir tərəfi tək regenerasiya edə bilərsiniz. Bir tərəf alət çağırdıqda göndərdiyiniz nəticə yalnız həmin tərəfi davam etdirir.

Paylaşma, ixrac və idxal

  • Copy share link söhbəti linkin özünə, #-dən sonrakı hissəyə yığır. Heç nə yüklənmir. Təsvirlər, açarınız və son işləmənin təfərrüatları çıxarılır. Linki açan şəxs söhbəti öz playground-unda yeni söhbət kimi alır.
  • Link üçün çox uzun söhbət qeydlə rədd edilir. Əvəzində onu JSON kimi yükləyin.
  • Download conversation JSON söhbəti parametrləri ilə fayl kimi saxlayır. Söhbətlər panelindəki Import JSON belə faylı açır.
  • Copy as cURL cari sorğunu bir cURL komandası kimi kopyalayır.

Nə harada saxlanılır

Nə Harada saxlanılır
Söhbətlər, saxlanılmış alətlər, son modellər, panel düzəni Bu brauzerdə. Shannon-a göndərilmir və başqa cihaza keçmir.
API açarı Açıq tabın yaddaşında. Yapışdırılmış açar səhifə yenidən yüklənəndə və ya tab bağlananda itir. Daxil olduqda açar hər dəfə hesabınızdan oxunur.
Son növbənin axın hadisələri, başlıqları və sorğusu Açıq səhifədə, yenidən yüklənənə qədər.
Sorğular Brauzerinizdən API-yə açarınızla göndərilir. Hər digər API sorğusu kimi balansınızdan hesablanır.

Klaviatura

Düymələr Nə edir
Enter Mesajı göndərir.
Shift + Enter Yeni sətir başlayır.
Ctrl + K Komanda palitrasını açır: endpoint və ya modeli dəyişmək, system şablonu təyin etmək, yeni söhbət başlatmaq, streaming, alətlər və ya müqayisəni açıb-bağlamaq. Mac-də: ⌘ K.
Esc Yazılmaqda olan cavabı dayandırır və ya dar ekranda açıq paneli bağlayır.

Playground-u işə sal