Langkau ke kandungan
Taman Permainan API

Taman Permainan API

Interaktif

Cuba setiap model dan endpoint dalam pelayar dengan kunci anda sendiri — output streaming, pemeriksa permintaan dan kod yang dijana yang boleh anda tampal terus ke dalam aplikasi anda.

Lancarkan Playground

Playground ialah konsol sembang untuk API di /docs/playground. Anda bercakap dengan model, dan playground menghantar permintaan yang sama seperti yang dihantar oleh kod anda: ke salah satu daripada tiga endpoint, dengan model, system prompt, parameter dan alat yang anda tetapkan. Setiap permintaan boleh dibaca semula sebagai kod dan sebagai peristiwa stream mentah.

Mula

  • Berikan kunci — Apabila log masuk, playground menggunakan kunci API akaun anda dan menunjukkan baki anda. Jika tidak log masuk, pilih Tambah kunci dan tampal kunci: ia disimpan dalam tab ini sahaja dan tidak pernah disimpan.
  • Pilih endpoint dan model — Bar atas memegang suis endpoint dan pemilih model. Perbualan baharu bermula pada Chat Completions dengan shannon-3.
  • Hantar mesej — Taip di bawah dan tekan Enter. Setiap balasan menyertai perbualan, jadi mesej seterusnya menyambungnya. Skrin kosong menawarkan tiga prompt permulaan dan contoh panggilan alat yang sedia ada.

Anda menemui dan memutar kunci anda pada halaman Kunci & penggunaan. Kunci & penggunaan

Endpoint dan model

Suis endpoint menentukan format permintaan yang dibina oleh playground. Anda boleh menukarnya di tengah-tengah perbualan; mesej kekal.

Endpoint Permintaan yang dihantarnya Rujukan
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses API Responses
Messages POST /v1/messages Format Antropik

Pemilih model menyenaraikan apa yang dipulangkan oleh GET /v1/models. Ia boleh dicari, mengekalkan model terkini anda di atas, dan menunjukkan bagi setiap model harga bagi setiap 1M token, tetingkap konteks serta tanda untuk alat, input imej, penaakulan dan output berstruktur.

Perbualan

  • Balasan di-stream ke dalam perbualan semasa ia ditulis. Penaakulan model dipaparkan dalam blok tersendiri yang boleh anda lipat.
  • Di bawah setiap balasan: masa ke token pertama, token sesaat, masa berlalu, token input dan output dengan bahagian cached dan penaakulan, anggaran kos giliran itu, sebab selesai dan id respons.
  • Mesej anda boleh disunting dan dihantar semula dari titik itu. Balasan boleh dijana semula. Mesej boleh dipadam, dan pemadaman boleh dibatalkan selama beberapa saat.
  • Henti atau kekunci Esc menamatkan balasan yang sedang ditulis.
  • Imej dilampirkan dengan butang imej, dengan menampal atau dengan menjatuhkan fail, untuk model yang menerima imej. Imej diskalakan kepada 1,568 piksel pada sisi panjangnya sebelum dihantar. Fail melebihi 30 MB dilangkau.
  • Ruang penulis dan system prompt menunjukkan bilangan token. Bagi model open-weight yang dihoskan, ia ialah kiraan tepat daripada POST /v1/tokenize. Bagi model lain, ia ialah anggaran, ditandakan dengan ≈.
  • Permintaan yang gagal menunjukkan apa yang perlu dibuat seterusnya: tetapkan kunci apabila kunci ditolak, tambah nilai apabila baki habis, bilangan saat untuk menunggu selepas terlalu banyak permintaan, atau cuba semula selepas ralat server.

Tetapan permintaan

Butang Tetapan membuka panel dengan enam tab. Tetapan dimiliki oleh perbualan: setiap perbualan menyimpan tetapannya sendiri.

Tab Apa yang dipegangnya
Sistem System prompt perbualan, dihantar bersama setiap permintaan. Lima templat mengisinya, dan bilangan tokennya dipaparkan.
Parameter Maksimum token output, suhu, top_p, usaha penaakulan, jujukan henti, seed, dan suis untuk streaming dan carian web. Kawalan yang tiada medannya pada endpoint yang dipilih dimatikan dan ditandakan.
Alatan Takrifan alat yang dihantar bersama permintaan: empat pratetap (get_weather, read_file, run_shell, web_search) atau takrifan anda sendiri sebagai JSON, dan tool_choice (auto, none, required atau satu alat mengikut nama). Apabila model memanggil alat, perbualan menunjukkan panggilan itu dengan kotak untuk keputusan. Dengan Tawarkan contoh keputusan dihidupkan, satu klik mengisi contoh keputusan. Anda juga boleh menaip sendiri, kemudian menghantarnya untuk menyambung giliran.
Berstruktur response_format: text, json_object atau json_schema dengan nama skema dan JSON schema. Dengan skema ditetapkan, jawapan terakhir disemak terhadapnya dan ditandakan dalam perbualan sebagai sepadan atau tidak. Tab ini dimatikan pada endpoint Messages, dan pilihan yang tidak diterima oleh model yang dipilih tidak ditawarkan.
Kod Permintaan perbualan semasa sebagai kod cURL, Python, Node atau Go, dibina daripada perbualan dan tetapannya. Kunci dicetak sebagai YOUR_API_KEY. Kod boleh disalin atau dibuka dalam paparan besar.
Peristiwa Giliran terakhir seperti yang melalui rangkaian: setiap peristiwa stream dengan anjakan masanya dan penapis, balasan yang dipasang, header balasan (x-request-id, content-type, retry-after, date) dan badan permintaan. Ini disimpan sehingga halaman dimuat semula.

Semakan input

Nilai yang anda taip disemak sebelum permintaan dihantar. Nilai di luar julat ditandakan pada medannya, dan penghantaran ditahan sehingga ia dibetulkan.

Tetapan Semakan
Maksimum token output Nombor bulat daripada 1 hingga max_output_tokens model.
Suhu Nombor daripada 0 hingga 2. Jika kosong, medan itu tidak dimasukkan dalam permintaan.
top_p Nombor daripada 0 hingga 1. Jika kosong, medan itu tidak dimasukkan dalam permintaan.
seed Nombor bulat.
Jujukan henti Paling banyak 4, diasingkan dengan koma.
response_format Mestilah yang diterima oleh model yang dipilih. Perbualan yang dialihkan kepada model tanpa json_schema atau tanpa response_format ditahan dengan sebabnya.
Imej Dikeluarkan daripada mesej apabila anda bertukar kepada model yang hanya menerima teks, dengan nota.

Bandingkan dua model

Bandingkan dua model dalam menu Lagi menambah pemilih model kedua. Setiap mesej kemudian dihantar kepada kedua-dua model pada masa yang sama, dengan tetapan yang sama, dan kedua-dua jawapan berdiri bersebelahan, ditandakan A dan B. Anda boleh menjana semula satu sisi sahaja. Apabila satu sisi memanggil alat, keputusan yang anda hantar hanya menyambung sisi itu.

Kongsi, eksport dan import

  • Salin pautan kongsi memadatkan perbualan ke dalam pautan itu sendiri, dalam bahagian selepas #. Tiada apa-apa dimuat naik. Imej, kunci anda dan butiran larian terakhir tidak dimasukkan. Sesiapa yang membuka pautan itu mendapat perbualan sebagai perbualan baharu dalam playground mereka sendiri.
  • Perbualan yang terlalu panjang untuk pautan ditolak dengan nota. Muat turunnya sebagai JSON sebaliknya.
  • Muat turun JSON perbualan menyimpan perbualan beserta tetapannya sebagai fail. Import JSON dalam panel perbualan membuka fail sedemikian.
  • Salin sebagai cURL menyalin permintaan semasa sebagai satu arahan cURL.

Apa yang disimpan di mana

Apa Tempat ia disimpan
Perbualan, alat yang disimpan, model terkini, susun atur panel Dalam pelayar ini. Ia tidak dihantar kepada Shannon dan tidak mengikut anda ke peranti lain.
Kunci API Dalam memori tab yang terbuka. Kunci yang ditampal hilang apabila halaman dimuat semula atau tab ditutup. Apabila log masuk, kunci dibaca daripada akaun anda setiap kali.
Peristiwa stream, header dan permintaan bagi giliran terakhir Dalam halaman yang terbuka, sehingga ia dimuat semula.
Permintaan Dihantar daripada pelayar anda kepada API dengan kunci anda. Ia dikira terhadap baki anda seperti permintaan API yang lain.

Papan kekunci

Kekunci Apa yang dilakukannya
Enter Hantar mesej.
Shift + Enter Mulakan baris baharu.
Ctrl + K Buka palet arahan: tukar endpoint atau model, tetapkan templat sistem, mulakan perbualan baharu, togol streaming, alat atau bandingan. Pada Mac: ⌘ K.
Esc Hentikan balasan yang sedang ditulis, atau tutup panel yang terbuka pada skrin sempit.

Lancarkan Playground