İçeriğe geç
API Oyun Alanı

API Oyun Alanı

Etkileşimli

Her modeli ve uç noktayı tarayıcıda kendi anahtarınızla deneyin — streaming çıktı, istek denetçisi ve doğrudan uygulamanıza yapıştırabileceğiniz üretilmiş kod.

Playground'u başlat

Playground, /docs/playground adresindeki API için bir sohbet konsoludur. Bir modelle konuşursunuz ve playground, kodunuzun göndereceği istekleri gönderir: üç uç noktadan birine, belirlediğiniz model, sistem istemi, parametreler ve araçlarla. Her istek kod olarak ve ham stream olayları olarak yeniden okunabilir.

Başlangıç

  • Ona bir anahtar verin — Oturum açıkken playground hesabınızın API anahtarını kullanır ve bakiyenizi gösterir. Oturum açık değilse Anahtar ekle seçeneğini seçip bir anahtar yapıştırın: yalnızca bu sekmede tutulur ve asla kaydedilmez.
  • Bir uç nokta ve bir model seçin — Üst çubukta uç nokta anahtarı ve model seçici bulunur. Yeni bir konuşma Chat Completions üzerinde shannon-3 ile başlar.
  • Bir mesaj gönderin — Aşağıya yazın ve Enter'a basın. Her yanıt konuşmaya katılır, böylece sonraki mesaj onu sürdürür. Boş ekran üç başlangıç istemi ve hazır bir araç çağrısı örneği sunar.

Anahtarınızı Keys & usage sayfasında bulur ve yenilersiniz. Keys & usage

Uç noktalar ve modeller

Uç nokta anahtarı, playground'un hangi istek biçimini oluşturacağını belirler. Bir konuşmanın ortasında değiştirebilirsiniz; mesajlar kalır.

Uç nokta Gönderdiği istek Başvuru
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic Biçimi

Model seçici, GET /v1/models yanıtının döndürdüklerini listeler. Aranabilir, son kullandığınız modelleri üstte tutar ve her model için 1M token başına fiyatı, bağlam penceresini ve araçlar, görsel girdisi, akıl yürütme ve yapılandırılmış çıktı için işaretleri gösterir.

Konuşma

  • Yanıtlar yazıldıkça konuşmaya akar. Modelin akıl yürütmesi, katlayabileceğiniz ayrı bir blokta gösterilir.
  • Her yanıtın altında: ilk token'a kadar geçen süre, saniyedeki token, geçen süre, önbelleğe alınmış ve akıl yürütme kısımlarıyla giriş ve çıktı token'ları, turun maliyet tahmini, bitiş nedeni ve yanıt kimliği.
  • Bir mesajınız düzenlenip o noktadan yeniden gönderilebilir. Bir yanıt yeniden oluşturulabilir. Bir mesaj silinebilir ve silme birkaç saniye boyunca geri alınabilir.
  • Durdur veya Esc tuşu yazılmakta olan yanıtı sonlandırır.
  • Görseller, görsel kabul eden modeller için görsel düğmesiyle, yapıştırarak ya da bir dosya bırakarak eklenir. Bir görsel gönderilmeden önce uzun kenarı 1,568 piksele ölçeklenir. 30 MB üzerindeki dosya atlanır.
  • Mesaj kutusu ve sistem istemi bir token sayısı gösterir. Host edilen açık ağırlıklı modellerde bu, POST /v1/tokenize sonucundaki kesin sayıdır. Diğer modellerde bir tahmindir ve ≈ ile işaretlenir.
  • Başarısız bir istek sonraki adımı gösterir: anahtar reddedildiyse bir anahtar ayarlayın, bakiye bittiyse yükleme yapın, çok fazla istekten sonra beklenecek saniyeyi görün ya da sunucu hatasından sonra yeniden deneyin.

İstek ayarları

Ayarlar düğmesi altı sekmeli bir panel açar. Ayarlar konuşmaya aittir: her konuşma kendi ayarlarını tutar.

Sekme İçerdiği
Sistem Konuşmanın sistem istemi; her istekle gönderilir. Beş şablon onu doldurur ve token sayısı gösterilir.
Parametreler Maksimum çıktı token'ı, sıcaklık, top_p, akıl yürütme çabası, durdurma dizileri, seed ve streaming ile web araması anahtarları. Seçili uç noktada alanı olmayan bir kontrol kapatılır ve işaretlenir.
Araçlar İstekle gönderilen araç tanımları: dört hazır ayar (get_weather, read_file, run_shell, web_search) ya da JSON olarak kendi tanımınız ve tool_choice (auto, none, required ya da adıyla bir araç). Model bir araç çağırdığında konuşma, çağrıyı sonuç için bir kutuyla gösterir. Örnek sonuçlar sun açıkken tek tıklama örnek bir sonuç doldurur. Kendi sonucunuzu da yazıp turu sürdürmek için gönderebilirsiniz.
Yapılandırılmış response_format: text, json_object ya da bir şema adı ve bir JSON şemasıyla json_schema. Bir şema ayarlıyken son yanıt ona göre denetlenir ve konuşmada uyuyor ya da uymuyor olarak işaretlenir. Sekme Messages uç noktasında kapalıdır ve seçili modelin kabul etmediği bir seçenek sunulmaz.
Kod Geçerli konuşmanın isteği, konuşmadan ve ayarlarından oluşturulmuş cURL, Python, Node veya Go kodu olarak. Anahtar YOUR_API_KEY olarak yazılır. Kod kopyalanabilir ya da büyük görünümde açılabilir.
Olaylar Son tur, ağ üzerinden gittiği haliyle: zaman farkı ve filtresiyle her stream olayı, birleştirilmiş yanıt, yanıt başlıkları (x-request-id, content-type, retry-after, date) ve istek gövdesi. Bunlar sayfa yeniden yüklenene kadar tutulur.

Girdi denetimleri

Yazdığınız değerler bir istek gönderilmeden önce denetlenir. Aralık dışındaki bir değer kendi alanında işaretlenir ve düzeltilene kadar gönderim durdurulur.

Ayar Denetim
Maksimum çıktı token'ı 1 ile modelin max_output_tokens değeri arasında bir tam sayı.
Sıcaklık 0 ile 2 arasında bir sayı. Boş bırakılırsa alan istekten çıkarılır.
top_p 0 ile 1 arasında bir sayı. Boş bırakılırsa alan istekten çıkarılır.
seed Bir tam sayı.
Durdurma dizileri En fazla 4, virgülle ayrılmış.
response_format Seçili modelin kabul ettiği biri olmalıdır. json_schema desteği olmayan ya da response_format desteği olmayan bir modele taşınan konuşma, nedeniyle birlikte durdurulur.
Görseller Yalnızca metin kabul eden bir modele geçtiğinizde bir notla mesajdan çıkarılır.

İki modeli karşılaştırma

Diğer menüsündeki İki modeli karşılaştır ikinci bir model seçici ekler. Bundan sonra her mesaj aynı ayarlarla iki modele aynı anda gider ve iki yanıt A ve B olarak işaretlenerek yan yana durur. Yalnızca bir tarafı yeniden oluşturabilirsiniz. Bir taraf araç çağırdığında, gönderdiğiniz sonuç yalnızca o tarafı devam ettirir.

Paylaşma, dışa ve içe aktarma

  • Paylaşım bağlantısını kopyala konuşmayı bağlantının kendisine, # sonrasındaki bölüme paketler. Hiçbir şey yüklenmez. Görseller, anahtarınız ve son çalıştırmanın ayrıntıları dışarıda bırakılır. Bağlantıyı açan kişi konuşmayı kendi playground'unda yeni bir konuşma olarak alır.
  • Bir bağlantı için çok uzun olan konuşma bir notla reddedilir. Onun yerine JSON olarak indirin.
  • Konuşma JSON'ını indir konuşmayı ayarlarıyla birlikte bir dosya olarak kaydeder. Konuşmalar panelindeki JSON İçe Aktar böyle bir dosyayı açar.
  • cURL olarak kopyala geçerli isteği tek bir cURL komutu olarak kopyalar.

Neyin nerede tutulduğu

Ne Nerede tutulur
Konuşmalar, kaydedilen araçlar, son modeller, panel düzeni Bu tarayıcıda. Shannon'a gönderilmezler ve başka bir cihazda sizi izlemezler.
API anahtarı Açık sekmenin belleğinde. Yapıştırılan bir anahtar, sayfa yeniden yüklendiğinde ya da sekme kapandığında gider. Oturum açıkken anahtar her seferinde hesabınızdan okunur.
Son turun stream olayları, başlıkları ve isteği Açık sayfada, yeniden yüklenene kadar.
İstekler Tarayıcınızdan API'ye anahtarınızla gönderilir. Diğer her API isteği gibi bakiyenizden sayılırlar.

Klavye

Tuşlar Ne yapar
Enter Mesajı gönder.
Shift + Enter Yeni satır başlat.
Ctrl + K Komut paletini aç: uç noktayı ya da modeli değiştir, bir sistem şablonu ayarla, yeni konuşma başlat, streaming'i, araçları ya da karşılaştırmayı aç/kapat. Mac'te: ⌘ K.
Esc Yazılmakta olan yanıtı durdur ya da dar ekranda açık bir paneli kapat.

Playground'u başlat