Model gratis

Model yang id-nya berakhiran :free ditagih Rp 0. Kamu bisa memanggilnya dengan akun baru dan saldo nol, dalam batas per menit dan batas harian yang naik saat kamu top up atau berlangganan. Halaman ini membahas akhiran :free, rute kenari-free, dan batas-batas itu.

Pakai model gratis

Kirim id model :free seperti model lainnya. Ini berlaku di Chat completions, Messages, dan Responses.

curl https://kenari.id/v1/chat/completions \
  -H "Authorization: Bearer $KENARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "step-3-7-flash:free",
    "messages": [{"role": "user", "content": "Halo!"}]
  }'

Lihat model gratis yang tersedia saat ini lewat panggilan publik yang tidak butuh key:

curl -s https://kenari.id/v1/models | jq -r '.data[] | select(.pricing.free) | .id'

Model gratis tetap bisa menampilkan harga katalog di pricing. Harga itu tidak pernah ditagih.

Rute kenari-free

kenari-free adalah rute bawaan yang memilihkan model gratis untukmu. Kirim sebagai model, lalu kenari mencoba model gratis dalam urutan acak dan pindah ke model berikutnya saat sebuah model gagal. Rute ini tampil sebagai rute baca-saja di BYOK & Rute dan tidak bisa diubah atau dihapus.

{
  "model": "kenari-free",
  "messages": [{"role": "user", "content": "Halo!"}]
}

Kalau request memuat tools, kenari hanya mencoba model gratis yang mendukung tool calling. Kalau tidak ada yang mendukung, request gagal dengan HTTP 400. Kirim request itu ke id model tertentu yang mendukung tools.

Paket juga bisa mengalihkan request ke kenari-free saat kuotanya habis. Lihat Langganan. Untuk rute yang kamu buat sendiri, lihat Routing & rute.

Batas

Model gratis punya dua batas per akun, dan keduanya berlaku untuk setiap request ke model gratis.

Batas	Cara kerjanya
Per menit	Jumlah request yang boleh dikirim akun ke model gratis dalam semenit.
Per hari	Jumlah request berhasil yang boleh dilakukan akun ke model gratis dalam sehari. Nilai `0` berarti tanpa batas harian.

Batasnya bergantung pada akun:

Akun	Yang berlaku
Akun baru	Batas terkecil. Model gratis bisa dipakai sejak request pertama.
Setelah top up yang memenuhi syarat	Batas harian dan batas per menit yang lebih tinggi. Akun memenuhi syarat saat total top up dan pembayaran paketnya mencapai ambang tertentu. Saldo bonus dari kode tidak dihitung.
Akun dengan paket aktif	Batas per menit tertinggi. Batas hariannya berasal dari paket kalau paket menyetelnya sendiri, kalau tidak dari nilai bawaan untuk akun berpaket.

Satu model bisa punya batas per menit atau batas harian sendiri, yang lalu berlaku menggantikan batas akun untuk model itu. Akun yang belum memenuhi syarat juga bisa dikenai batas per menit yang lebih rendah di semua model gratis.

Tempat angka terbaru

Batas dan ambang top up bisa berubah, jadi angkanya tidak ditulis di sini. Baca dari salah satu tempat ini:

Halaman Langganan di dashboard, dan tabel paket di akhir Langganan.
GET /api/public/pricing, yang tidak butuh key. Objek free_tier-nya menjelaskan tiga akun di atas, dengan field berikut:

curl -s https://kenari.id/api/public/pricing | jq '.free_tier'

Field	Artinya
`daily`, `rpm`	Batas harian dan batas per menit untuk akun baru.
`threshold_idr`	Total top up dan pembayaran paket, dalam Rupiah, yang dibutuhkan untuk memenuhi syarat.
`next`	Batas setelah akun memenuhi syarat. Bernilai `null` kalau tidak perlu top up, karena akun baru sudah mulai dari sana.
`plan`	Batas dengan paket aktif. Nilai harian milik paket ada di field `free_daily_quota_effective` pada `GET /api/plans`.

Ketersediaan

Model gratis berjalan secara best-effort, jadi kecepatan dan ketersediaannya bisa berbeda dari model berbayar. Jika kapasitas gratis tidak cukup, pakai model berbayar.

Saat mencapai batas

Request yang melewati batas model gratis mengembalikan HTTP 429. Lihat Batas laju untuk kode error dan cara mencoba ulang.

Model khusus pelanggan

Sebagian model hanya untuk akun dengan paket aktif. Request dari akun lain mengembalikan HTTP 403 dengan kode subscribers_only. Lihat Langganan.