Ringkasan integrasi

Alat apa pun yang memakai API OpenAI atau Anthropic bisa memakai kenari dengan mengganti base URL dan key. Satu key kn- berlaku untuk semua model dan kedua format API. Buat key di API Keys pada dashboard. Lihat Autentikasi & API key.

Base URL

Jenis klien	Base URL	Contoh
SDK dan alat yang kompatibel dengan OpenAI	`https://kenari.id/v1`	SDK OpenAI, OpenCode, Zoo Code, Hermes, OpenClaw, Kimi Code
Klien OpenAI Responses	`https://kenari.id/v1`	Codex
SDK Anthropic dan Claude Code	`https://kenari.id`	SDK Anthropic, Claude Code

Baris Anthropic berlaku untuk SDK Anthropic dan Claude Code, yang menambahkan /v1/messages sendiri, jadi base URL-nya tanpa /v1. Kalau kamu menambahkannya, request menuju /v1/v1/messages dan mengembalikan 405.

import os
import anthropic
from openai import OpenAI

openai_client = OpenAI(base_url="https://kenari.id/v1", api_key=os.environ["KENARI_API_KEY"])
anthropic_client = anthropic.Anthropic(base_url="https://kenari.id", api_key=os.environ["KENARI_API_KEY"])

Id model yang valid ada di Model & harga. Untuk mencoba dengan saldo nol, pakai model :free seperti step-3-7-flash:free.

Panduan khusus

Claude Code: tiga variabel environment.
Codex: provider di config.toml.
CLI kenari: campur model native dan kenari per role.
Server MCP: docs, daftar model, dan tool web untuk klien MCP apa pun.
Dokumentasi untuk agen AI: llms.txt, halaman Markdown, dan OpenAPI.

Claude Code Router

Claude Code Router (CCR) bisa menambahkan kenari sebagai provider lewat sebuah link. Di mesin yang sudah terpasang CCR, buka tambahkan kenari ke CCR. Link itu mengarahkan CCR ke manifest publik di https://kenari.id/.well-known/ccr-provider.json. Manifest berisi base URL, format API, dan model chat yang mendukung function calling, jadi kamu tidak mengatur apa pun secara manual. CCR menampilkan pratinjau sebelum menyimpan apa pun, dan meminta key kn- kamu di dialog konfirmasi. Key tidak ada di dalam link maupun manifest.

Manifest tidak butuh key dan diperbarui setiap beberapa menit. CCR membacanya saat kamu membuka link, jadi buka link itu lagi untuk mendapat model baru.

Kalau link tidak melakukan apa-apa, CCR belum terpasang atau tidak menangani skema ccr://. Pakai Claude Code dengan variabel environment sebagai gantinya.

OpenCode

Di OpenCode, ketik /connect, pilih Kenari dari daftar provider, tempel key, lalu pilih model. Mengatur KENARI_API_KEY di environment juga bisa tanpa /connect. Untuk konfigurasi opencode.json, ikuti dokumentasi OpenCode.

OmniRoute

Jalankan omniroute setup atau buka dashboard OmniRoute, pilih Kenari dari daftar provider, lalu tempel key. Semua model katalog langsung tersedia lewat endpoint OmniRoute-mu, bersama aturan fallback bawaan OmniRoute. Lihat dokumentasi OmniRoute.

Zoo Code

Buka pengaturan Zoo Code, pilih Kenari di API Provider, tempel key, lalu pilih model. Zoo Code memuat daftar model dari /v1/models, jadi model baru muncul tanpa pembaruan ekstensi. Lihat panduan Zoo Code.

Hermes

Hermes menerima endpoint yang kompatibel dengan OpenAI. Pakai https://kenari.id/v1 sebagai base URL dan key kenari kamu sebagai OPENAI_API_KEY. Cara pastinya berbeda antar versi, jadi ikuti dokumentasi Hermes.

OpenClaw

OpenClaw menerima provider kustom lewat flag --custom-base-url, --custom-provider-id, --custom-model-id, dan --custom-compatibility. Atur base URL ke https://kenari.id/v1 dan key ke key kn- kamu. Lihat dokumentasi OpenClaw untuk format pastinya.

Kimi Code

Kimi Code bisa mengimpor kenari sebagai provider dari registry publik. Jalankan:

kimi provider add https://kenari.id/.well-known/models.dev.json

Registry berisi semua model chat kenari beserta jendela konteks, output terpanjang, dan apakah model membaca gambar serta memanggil fungsi. Registry tidak butuh key dan diperbarui setiap beberapa menit. Kimi Code memeriksa URL yang sama lagi saat dijalankan berikutnya, jadi model baru muncul tanpa perintah lain.

Impor tidak menyimpan key kamu. Tambahkan satu baris di bagian [providers.kenari] pada ~/.kimi-code/config.toml, lalu ekspor key di shell:

api_key_env = "KENARI_API_KEY"

Lalu pilih model kenari dengan /model, atau jalankan Kimi Code dengan -m dan nama model dari daftar. Registry menampilkan 0 untuk harga karena kenari menagih dalam Rupiah. Lihat Model & harga untuk harga yang sebenarnya. Untuk opsi lain dari kimi provider, ikuti dokumentasi Kimi Code.

Troubleshooting

Gejala	Penyebab	Solusi
`401` dengan `invalid key` atau `missing authorization`	Key belum diatur, belum termuat, atau tidak diawali `kn-`.	Salin ulang key dari API Keys, lalu restart alat atau buka terminal baru.
`400` dengan `model_not_found`	Id model salah ketik atau tidak ada di katalog.	Salin id dari Model & harga.
`402` dengan `insufficient_balance`	Model berbayar dan saldo yang tersedia tidak cukup untuk perkiraan biaya request.	Pakai model `:free`, perpendek prompt, atau top up. Lihat Cara request chat ditagih.
`405`	Bentuk base URL salah, misalnya `/v1/v1` atau tanpa `/v1`.	Pakai `https://kenari.id/v1` untuk klien kompatibel OpenAI dan `https://kenari.id` untuk SDK Anthropic dan Claude Code. Di CCR, pertahankan base URL dari link integrasinya.