Untuk agen AI

Halaman ini menjelaskan cara agen AI (dan orang yang merangkainya) memakai kenari secara hemat. Semua endpoint kompatibel dengan OpenAI atau Anthropic, dan dokumentasinya tersedia dalam bentuk yang mudah dibaca mesin.

Instruksi untuk agen

Catatan Empat jalan pintas untuk agen: tambahkan .md ke URL docs untuk Markdown bersih, panggil GET /v1/models untuk harga live, baca /llms-full.txt untuk seluruh referensi dalam satu file, dan pakai server MCP di https://kenari.id/mcp.

Format dokumentasi

llms.txt dan llms-full.txt

Dua berkas teks biasa membantu model memuat dokumentasi tanpa key:

• /llms.txt: indeks ringkas, satu tautan dan satu baris per bagian. Muat di context window mana pun.
• /llms-full.txt: seluruh dokumentasi digabung jadi satu file, untuk dibaca sekali.

curl https://kenari.id/llms.txt
curl https://kenari.id/llms-full.txt

Halaman sebagai Markdown

Tiap halaman docs tersedia sebagai Markdown bersih. Tambahkan .md pada URL halaman, misalnya https://kenari.id/docs/chat.md.

/docs.md berisi seluruh dokumentasi dalam satu file Markdown.

curl https://kenari.id/docs/chat.md
curl https://kenari.id/docs.md

Bagi model, Markdown sekitar 30x lebih hemat token daripada HTML, jadi pilih format ini saat memberi konteks ke agen.

Integrasi dan katalog

openapi.json

Spesifikasi OpenAPI 3.1 ada di https://kenari.id/openapi.json. File ini menjelaskan keempat endpoint /v1, skema bearer kn-..., bentuk request dan response, serta format error. Cocok untuk generator kode, Postman, dan eksplorer API.

curl https://kenari.id/openapi.json

Claude Code

kenari mendukung protokol Anthropic secara penuh di /v1/messages: semua id model di katalog bisa dipakai, termasuk tool calling dan streaming. ANTHROPIC_API_KEY (dikirim lewat header x-api-key) juga diterima, dan POST /v1/messages/count_tokens tersedia sehingga pelacakan konteks Claude Code berjalan seperti biasa. Langkah setup lengkapnya ada di Editor & agen AI.

Server MCP

Server Model Context Protocol di https://kenari.id/mcp mengekspos tool berikut:

Tool	Fungsi	Butuh key
kenari_search_docs	Cari di dokumentasi.	tidak
kenari_list_models	Daftar model beserta harga IDR live.	tidak
kenari_balance	Saldo kamu (Rupiah).	ya
kenari_usage	Pemakaian 30 hari terakhir per model.	ya
kenari_quota	Kuota paket dan kupon kamu (Rupiah).	ya
kenari_web_search	Cari di web secara live, hasil berupa daftar tautan berperingkat.	ya
kenari_web_fetch	Ambil konten bersih dari satu URL.	ya
kenari_x_search	Cari X (dulu Twitter) secara live, hasil berupa jawaban dengan tautan sumber.	ya

Tambahkan endpoint ini ke Claude Code, Cursor, atau klien MCP lain. Tool tanpa key bersifat publik. Untuk kenari_balance, kenari_usage, kenari_quota, kenari_web_search, kenari_web_fetch, dan kenari_x_search, set header Authorization: Bearer kn-... (API key kamu) pada konfigurasi server MCP-nya. Tiga tool terakhir juga ditagih ke saldo per pemanggilan.

Header juga menerima x-api-key kalau klien MCP kamu memakai gaya itu. Authorization menang saat keduanya ada.

Kunci yang dibagikan Kalau key yang kamu pakai berasal dari halaman berbagi, kenari_balance, kenari_usage, dan kenari_quota akan ditolak: ketiganya membaca data akun pemilik key, bukan data kamu. Tool yang membelanjakan saldo (kenari_web_search, kenari_web_fetch, kenari_x_search) tetap jalan, karena itu memang tujuan key dibagikan. Pakai key milik akun kamu sendiri untuk melihat angka saldo, pemakaian, dan kuota.

Umpan harga live

GET /v1/models (publik) dan GET /api/public/pricing mengembalikan daftar model dan harga token terbaru. Selalu panggil salah satu endpoint ini daripada menyalin angka statis, karena harga dan katalog model bisa berubah.

curl https://kenari.id/v1/models
curl https://kenari.id/api/public/pricing

Lihat juga Model & harga untuk struktur daftar model dan Penagihan untuk cara token dihitung menjadi Rupiah.