Langsung ke konten
Playground API

Playground API

Interaktif

Coba setiap model dan endpoint di browser dengan kunci Anda sendiri — output streaming, inspektur permintaan, dan kode hasil generate yang bisa langsung Anda tempel ke aplikasi.

Buka Playground

Playground adalah konsol chat untuk API di /docs/playground. Anda berbicara dengan model, dan playground mengirim permintaan yang sama seperti yang akan dikirim kode Anda: ke salah satu dari tiga endpoint, dengan model, system prompt, parameter, dan tool yang Anda setel. Setiap permintaan dapat dibaca kembali sebagai kode dan sebagai event stream mentah.

Mulai

  • Beri kunci — Jika sudah masuk, playground memakai kunci API akun Anda dan menampilkan saldo Anda. Jika belum masuk, pilih Tambah kunci dan tempel kunci: kunci hanya disimpan di tab ini dan tidak pernah disimpan permanen.
  • Pilih endpoint dan model — Bilah atas berisi pengalih endpoint dan pemilih model. Percakapan baru dimulai di Chat Completions dengan shannon-3.
  • Kirim pesan — Ketik di bawah dan tekan Enter. Setiap balasan bergabung ke percakapan, sehingga pesan berikutnya melanjutkannya. Layar kosong menawarkan tiga prompt awal dan contoh panggilan tool yang siap pakai.

Anda dapat menemukan dan merotasi kunci Anda di halaman Keys & usage. Keys & usage

Endpoint dan model

Pengalih endpoint menentukan format permintaan yang dibuat playground. Anda dapat mengubahnya di tengah percakapan; pesan tetap ada.

Endpoint Permintaan yang dikirim Referensi
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Format Anthropic

Pemilih model menampilkan apa yang dikembalikan GET /v1/models. Dapat dicari, menaruh model terbaru Anda di atas, dan menampilkan untuk tiap model harga per 1M token, jendela konteks, serta penanda untuk tool, input gambar, penalaran, dan output terstruktur.

Percakapan

  • Balasan mengalir ke thread saat ditulis. Penalaran model ditampilkan dalam blok tersendiri yang dapat Anda lipat.
  • Di bawah setiap balasan: waktu hingga token pertama, token per detik, waktu berlalu, token input dan output beserta bagian ter-cache dan penalarannya, perkiraan biaya giliran itu, finish reason, dan id respons.
  • Pesan Anda dapat diedit dan dikirim ulang dari titik itu. Balasan dapat dibuat ulang. Pesan dapat dihapus, dan penghapusan dapat dibatalkan selama beberapa detik.
  • Stop atau tombol Esc mengakhiri balasan yang sedang ditulis.
  • Gambar dilampirkan dengan tombol gambar, dengan menempel, atau dengan menjatuhkan file, untuk model yang menerima gambar. Gambar diperkecil ke 1,568 piksel pada sisi terpanjangnya sebelum dikirim. File di atas 30 MB dilewati.
  • Composer dan system prompt menampilkan jumlah token. Untuk model open-weight hosted, itu adalah jumlah pasti dari POST /v1/tokenize. Untuk model lain, itu perkiraan, ditandai dengan ≈.
  • Permintaan yang gagal menunjukkan apa yang harus dilakukan selanjutnya: setel kunci ketika kunci ditolak, isi ulang ketika saldo habis, jumlah detik menunggu setelah terlalu banyak permintaan, atau coba lagi setelah error server.

Pengaturan permintaan

Tombol Pengaturan membuka panel dengan enam tab. Pengaturan milik percakapan: setiap percakapan menyimpan pengaturannya sendiri.

Tab Isinya
System System prompt percakapan, dikirim bersama setiap permintaan. Lima template dapat mengisinya, dan jumlah tokennya ditampilkan.
Parameter Token output maksimum, temperature, top_p, reasoning effort, stop sequence, seed, serta sakelar untuk streaming dan pencarian web. Kontrol yang tidak memiliki field di endpoint terpilih dimatikan dan ditandai.
Tool Definisi tool yang dikirim bersama permintaan: empat preset (get_weather, read_file, run_shell, web_search) atau definisi Anda sendiri sebagai JSON, dan tool_choice (auto, none, required, atau satu tool berdasarkan nama). Ketika model memanggil tool, thread menampilkan panggilan itu dengan kotak untuk hasilnya. Dengan Offer sample results aktif, satu klik mengisi hasil contoh. Anda juga dapat mengetik hasil sendiri, lalu mengirimnya untuk melanjutkan giliran.
Terstruktur response_format: text, json_object, atau json_schema dengan nama skema dan skema JSON. Jika skema disetel, jawaban terakhir diperiksa terhadapnya dan ditandai di thread sebagai sesuai atau tidak. Tab ini dimatikan pada endpoint Messages, dan opsi yang tidak diterima model terpilih tidak ditawarkan.
Kode Permintaan percakapan saat ini sebagai kode cURL, Python, Node, atau Go, dibuat dari percakapan dan pengaturannya. Kunci dicetak sebagai YOUR_API_KEY. Kode dapat disalin atau dibuka dalam tampilan besar.
Event Giliran terakhir sebagaimana lewat di jaringan: setiap event stream dengan offset waktunya dan sebuah filter, balasan yang sudah dirakit, header balasan (x-request-id, content-type, retry-after, date), dan body permintaan. Semua ini disimpan sampai halaman dimuat ulang.

Pemeriksaan input

Nilai yang Anda ketik diperiksa sebelum permintaan dikirim. Nilai di luar rentang ditandai pada fieldnya, dan pengiriman ditahan sampai diperbaiki.

Pengaturan Pemeriksaan
Token output maksimum Bilangan bulat dari 1 sampai max_output_tokens model.
Temperature Angka dari 0 sampai 2. Jika kosong, field tidak disertakan dalam permintaan.
top_p Angka dari 0 sampai 1. Jika kosong, field tidak disertakan dalam permintaan.
seed Bilangan bulat.
Stop sequence Paling banyak 4, dipisahkan dengan koma.
response_format Harus salah satu yang diterima model terpilih. Percakapan yang dipindahkan ke model tanpa json_schema atau tanpa response_format ditahan disertai alasannya.
Gambar Dihapus dari pesan ketika Anda beralih ke model yang hanya menerima teks, disertai catatan.

Bandingkan dua model

Compare two models di menu Lainnya menambahkan pemilih model kedua. Setiap pesan kemudian dikirim ke kedua model secara bersamaan, dengan pengaturan yang sama, dan kedua jawaban ditampilkan berdampingan, bertanda A dan B. Anda dapat membuat ulang satu sisi saja. Ketika satu sisi memanggil tool, hasil yang Anda kirim hanya melanjutkan sisi itu.

Bagikan, ekspor, dan impor

  • Copy share link mengemas percakapan ke dalam tautan itu sendiri, pada bagian setelah #. Tidak ada yang diunggah. Gambar, kunci Anda, dan detail eksekusi terakhir tidak disertakan. Siapa pun yang membuka tautan mendapat percakapan itu sebagai percakapan baru di playground-nya sendiri.
  • Percakapan yang terlalu panjang untuk tautan ditolak disertai catatan. Unduh sebagai JSON sebagai gantinya.
  • Download conversation JSON menyimpan percakapan beserta pengaturannya sebagai file. Import JSON di panel percakapan membuka file seperti itu.
  • Copy as cURL menyalin permintaan saat ini sebagai satu perintah cURL.

Apa disimpan di mana

Apa Disimpan di mana
Percakapan, tool tersimpan, model terbaru, tata letak panel Di browser ini. Tidak dikirim ke Shannon dan tidak ikut ke perangkat lain.
Kunci API Di memori tab yang terbuka. Kunci yang ditempel hilang ketika halaman dimuat ulang atau tab ditutup. Jika sudah masuk, kunci dibaca dari akun Anda setiap kali.
Event stream, header, dan permintaan dari giliran terakhir Di halaman yang terbuka, sampai dimuat ulang.
Permintaan Dikirim dari browser Anda ke API dengan kunci Anda. Dihitung terhadap saldo Anda seperti permintaan API lainnya.

Keyboard

Tombol Fungsinya
Enter Kirim pesan.
Shift + Enter Mulai baris baru.
Ctrl + K Buka command palette: ganti endpoint atau model, setel template system, mulai percakapan baru, alihkan streaming, tool, atau perbandingan. Di Mac: ⌘ K.
Esc Hentikan balasan yang sedang ditulis, atau tutup panel yang terbuka pada layar sempit.

Buka Playground