Lewati ke konten
kenari.
Masuk

Mulai cepat

Kirim request pertamamu ke kenari dengan model gratis. Kamu butuh akun kenari, dan terminal atau proyek Python atau JavaScript.

1. Buat key

Section titled “1. Buat key”

Masuk ke dashboard, buka API Keys, lalu pilih Buat API Key. Isi label kalau mau, lalu pilih Buat Key. Segera salin key itu, karena kenari hanya menampilkannya sekali.

2. Simpan key

Section titled “2. Simpan key”

Simpan key di environment variable. Seluruh dokumentasi ini membacanya dari KENARI_API_KEY.

Terminal window
export KENARI_API_KEY=kn-...

3. Kirim request

Section titled “3. Kirim request”

Request ini memanggil model :free, jadi tidak dikenai biaya dan tetap dapat digunakan meskipun saldo kamu nol.

Terminal window
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!"}]
  }'

Panggilan yang berhasil mengembalikan HTTP 200 dan body JSON. Jawabannya ada di choices[0].message.content.

{
  "id": "...",
  "object": "chat.completion",
  "model": "step-3-7-flash:free",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Halo! Ada yang bisa saya bantu?" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 9, "completion_tokens": 10, "total_tokens": 19 }
}

Daftar model gratis berubah seiring waktu. Lihat yang aktif sekarang lewat endpoint model yang publik (perintahnya butuh jq):

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

4. Panggil dari kode

Section titled “4. Panggil dari kode”

SDK OpenAI bisa dipakai dengan kenari. Arahkan ke https://kenari.id/v1, sisa kodemu tetap sama.

Terminal window
pip install openai
import os
from openai import OpenAI


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


response = client.chat.completions.create(
    model="step-3-7-flash:free",
    messages=[{"role": "user", "content": "Halo!"}],
)
print(response.choices[0].message.content)
Terminal window
npm install openai
import OpenAI from "openai";


const client = new OpenAI({
  baseURL: "https://kenari.id/v1",
  apiKey: process.env.KENARI_API_KEY,
});


const response = await client.chat.completions.create({
  model: "step-3-7-flash:free",
  messages: [{ role: "user", content: "Halo!" }],
});
console.log(response.choices[0].message.content);

SDK Anthropic juga bisa dipakai, dengan base URL https://kenari.id tanpa /v1. Lihat Messages.

5. Top up untuk model berbayar

Section titled “5. Top up untuk model berbayar”

Model gratis punya batas per menit dan per hari. Untuk memanggil model berbayar, buka Saldo lalu top up lewat QRIS mulai Rp 1.000. Lihat Cara penagihan.

Troubleshooting

Section titled “Troubleshooting”
GejalaPenyebabSolusi
401 dengan body teks biasaKey tidak ada, salah ketik, terpotong saat disalin, atau sudah dicabutPeriksa echo $KENARI_API_KEY. Kalau key hilang, buat yang baru di API Keys.
400 dengan model_not_foundId model salahSalin id dari Model & harga.
402 dengan insufficient_balanceModel berbayar dipanggil saat saldo kurangGanti ke model :free, atau top up.
405Path base URL salah, misalnya /v1/v1 atau tanpa /v1Pakai https://kenari.id/v1 untuk klien OpenAI dan https://kenari.id untuk klien Anthropic.
429Batas laju tercapai. Bisa batas model gratis, batas akunmu, atau batas providerBaca code pada error, dan tunggu selama Retry-After jika response memuat header itu. Lihat Batas laju.

Lihat juga

Section titled “Lihat juga”