Lewati ke isi dokumentasi
Konsol

Konsol

Apa saja yang ada di konsol dan cara masuknya.

Panduan produk5 bagianAPI v1
Di halaman ini5 bagian

Ringkasan#

Di konsol kamu mengatur akun: membuat API key, mengisi saldo, melihat pemakaian, dan mencoba model lewat playground.

Konsol bukan API. Ia punya cara masuk sendiri, dan itu sebabnya kamu tidak menemukan rute konsol di dokumentasi ini. Rute-rute itu hanya dipanggil oleh halaman konsol, dan tidak ada yang perlu kamu sambungkan ke kodemu.

Cara masuk#

Konsol memakai cookie sesi yang dibuat saat kamu masuk. API pelanggan memakai API key sk-menv-.

Keduanya tidak bisa saling menggantikan, dan itu disengaja. Key yang bocor tidak membuka akunmu, dan sesi browser yang bocor tidak bisa dipakai memanggil API.

Playground#

Playground mengirim request lewat jalur yang sama dengan API pelanggan. Bukan simulasi: satu kiriman adalah satu panggilan chat yang ditagih.

Artinya tarif, penahanan saldo, dan batas laju di playground persis sama dengan yang berlaku saat kodemu memanggil API. Request dari playground memotong saldoseperti request biasa. Ia bukan mode uji coba gratis.

Playground mengirim chat: messages ke jalur chat, termasuk melampirkan gambar untuk model yang punya capabilities.vision. Permintaan media — gambar, text to speech, dan transkripsi — pindah ke Studio, ruang kerja yang formnya mengikuti metadata tiap model dan hasilnya tersimpan otomatis di perpustakaan. Jalur uangnya sama di keduanya: tarif, penahanan saldo, dan batas laju API.

Rincian tiap rute media tetap di dokumentasi: Gambar, Embeddings, dan Audio. Embeddings dan decisions belum punya permukaan di Studio dan tetap tersedia lewat API.

Playground memakai API key aktif terbaru milikmu, dan kamu tidak memilih key-nya di halaman ini. Pada kiriman non-streaming, hasilnya menyebut nama dan bentuk tersamar key yang dipakai. Kalau akunmu belum punya key aktif, kiriman ditolak 403 forbidden sebelum menyentuh model.

Dua hal yang sering mengejutkan. Pertama, tiap kiriman berdiri sendiri: riwayat percakapan tidak disimpan, jadi pesan sebelumnya tidak ikut ke kiriman berikutnya. Kedua, menghentikan stream di tengah bukan pembatalan biaya: server tetap membaca sampai selesai supaya pemakaian yang benar-benar terjadi bisa dihitung, dan yang ditagih adalah pemakaian itu — bukan estimasi awalnya.

Melihat kapabilitas model#

Katalog di konsol menyebut kemampuan tiap model, dan kemampuan itulah yang menentukan rute mana yang mau menerimanya.

Di halaman Model & Harga, tiap baris membawa chip kemampuan: streaming, tools, gambar untuk masukan gambar, dan penalaran. Tombol unduh JSON di bawah tabel membawa objek capabilities yang lebih lengkap, termasuk embeddings, audio, image, dan video — flag yang belum punya chip sendiri di tabel. GET /v1/models membawa flag yang sama di dalam capabilities, jadi kodemu bisa memeriksanya sebelum memilih model.

Rute yang kamu panggil menuntut satu flag, dan pasangannya tetap:

EndpointFlag yang dibutuhkan
/v1/chat/completionschat
/v1/messageschat
/v1/decisionschat
/v1/images/generationsimage
/v1/images/editsimage
/v1/audio/speechaudio
/v1/audio/transcriptionsaudio
/v1/embeddingsembeddings

Model yang tidak membawa flag yang diminta rute ditolak 422 sebelum ada uang yang ditahan. Dua kodenya berbeda, dan obatnya juga berbeda:

  • capability_mismatch: modelnya menyatakan flag itu false. Pakai model lain.
  • capabilities_not_declared: flag-nya tidak disebut sama sekali, atau capabilities modelnya kosong. Model itu perlu mendeklarasikan capabilities.<nama>: true lebih dulu.

Ketersediaan model media bergantung katalog, bukan rutenya. Rute media ada dan berjalan, tapi model yang dilayani di sana harus mendeklarasikan flag-nya dan punya harga aktif. Katalog yang terbit saat ini masih berisi model chat; belum ada model gambar atau audio di dalamnya, dan embeddings baru muncul di sebagian katalog. Kalau katalogmu belum memuat model dengan flag itu, rute tersebut menjawab 422 untuk model yang ada — bukan 404: rutenya ada, modelnya yang belum.

Satu penolakan lagi yang bukan soal kapabilitas: model yang flag-nya sudah benar tapi jalur medianya tidak tersedia di platform ini dijawab 501 surface_not_served. Request-mu benar; yang belum ada adalah jalur untuk melayaninya.

Field, satuan tagih, dan bentuk respons tiap endpoint media ada di Gambar, Embeddings, dan Audio.

Halaman konsol#

HalamanUntuk apa
DasborSaldo, pemakaian 30 hari, transaksi terbaru, dan tingkat aksesmu.
PlaygroundMengirim request chat lewat jalur yang sama dengan API.
Harga & katalogKatalog publik: tarif tiap model, filter kemampuan, dan contoh request siap salin. Halaman ini terbuka sebelum masuk.
API keyMembuat, menamai, membatasi, memutar, dan mencabut key; unduh audit log sebagai CSV.
PemakaianAgregat per rentang: request, token, dan biaya, dirinci per hari dan per model.
TransaksiBuku besar saldo: top up, biaya request, penahanan, dan refund manual.
Top upMembuat pembayaran, menukar voucher, dan riwayat pembayaran.
PengaturanProfil, kata sandi, tingkat akses dan batas gateway, serta hapus akun.
StatusHalaman publik status layanan; bisa dibuka tanpa masuk.