Dokumentasi
Cara memakai Kiyara AI Gateway: satu API key untuk semua model, kompatibel OpenAI & Anthropic.
Base URL
Semua endpoint memakai base URL ini.
<alamat-situs-anda>/v1Autentikasi
Buat API key di dashboard, lalu kirim sebagai header Authorization (OpenAI) atau x-api-key (Anthropic).
Authorization: Bearer sk-kiyara-... API key hanya ditampilkan sekali saat dibuat. Simpan di tempat aman; jangan dibagikan.
Jalur OpenAI-compatible
Kirim request seperti ke OpenAI. Cocok untuk SDK/library OpenAI apa pun.
curl <alamat-situs-anda>/v1/chat/completions \
-H "Authorization: Bearer sk-kiyara-..." \
-H "Content-Type: application/json" \
-d '{"model":"z-ai/glm-5.3","messages":[{"role":"user","content":"Halo"}]}' Streaming: set "stream": true (respons SSE dengan usage di akhir).
{"model":"z-ai/glm-5.3","stream":true,"messages":[{"role":"user","content":"Halo"}]} Contoh Python (SDK OpenAI):
from openai import OpenAI
client = OpenAI(
base_url="<alamat-situs-anda>/v1",
api_key="sk-kiyara-...",
)
resp = client.chat.completions.create(
model="z-ai/glm-5.3",
messages=[{"role": "user", "content": "Halo"}],
)
print(resp.choices[0].message.content)Jalur Anthropic-compatible
Untuk Anthropic SDK / Claude Code: cukup set base URL & API key, model tetap dari katalog Kiyara.
export ANTHROPIC_BASE_URL=
export ANTHROPIC_API_KEY=sk-kiyara-... curl <alamat-situs-anda>/v1/messages \
-H "x-api-key: sk-kiyara-..." \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"z-ai/glm-5.3","max_tokens":256,"messages":[{"role":"user","content":"Halo"}]}' Perkiraan jumlah token input (estimasi lokal, tanpa memotong saldo):
curl <alamat-situs-anda>/v1/messages/count_tokens \
-H "x-api-key: sk-kiyara-..." \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"z-ai/glm-5.3","messages":[{"role":"user","content":"Halo"}]}'Ekstensi VS Code
Pakai Kiyara langsung di dalam VS Code: chat dan bantuan coding dengan API key yang sama. Model diambil dari katalog Kiyara, jadi model baru otomatis muncul tanpa update ekstensi.
Pasang dari VS Code Marketplace (gratis):
Setelah dipasang, isi API key Kiyara di pengaturan ekstensi (kolom "Kiyara: API Key"). Base URL sudah terisi otomatis; ubah hanya bila memakai domain lain.
Pengaturan yang tersedia:
| kiyara.temperature | Kreativitas model (0–2). |
| kiyara.maxTokens | Batas token output; 0 = biarkan server menentukan. |
| kiyara.systemPrompt | System prompt default untuk setiap percakapan. |
| kiyara.defaultMaxInputTokens | Cadangan batas konteks bila metadata katalog tidak tersedia. |
| kiyara.defaultMaxOutputTokens | Cadangan batas output bila konteks belum diketahui. |
| kiyara.modelAllowList | Bila diisi, hanya model dalam daftar ini yang dimunculkan di pemilih model. |
| kiyara.visionModels | Paksa deteksi kemampuan gambar. Isi kode model untuk memaksa vision; beri awalan "-" untuk memaksa non-vision. |
| kiyara.debug | Log debug (tool yang dikirim/diminta) di panel Output "KiyaraRouter". |
Semua pengaturan punya nilai bawaan yang sudah bisa dipakai — tidak ada yang wajib diisi selain API key.
Daftar model
Lihat semua model aktif beserta harga. Gunakan kode model persis seperti ini.
curl <alamat-situs-anda>/v1/models \
-H "Authorization: Bearer sk-kiyara-..."Endpoint gambar
Model gambar ditagih PER GAMBAR (bukan per token). Dua endpoint tersedia, dan keduanya kompatibel dengan OpenAI Images API.
Text-to-image — bikin gambar baru dari teks (JSON):
curl <alamat-situs-anda>/v1/images/generations \
-H "Authorization: Bearer sk-kiyara-..." \
-H "Content-Type: application/json" \
-d '{"model":"openai/gpt-image-2.5","prompt":"a red apple on a wooden table","n":1}' Image-to-image — pakai gambar referensi. WAJIB multipart/form-data; satu gambar di field "image", banyak gambar di field "image[]" yang diulang:
curl <alamat-situs-anda>/v1/images/edits \
-H "Authorization: Bearer sk-kiyara-..." \
-F "model=openai/gpt-image-2.5" \
-F "prompt=combine both references into one poster" \
-F "image[]=@./ref1.png" \
-F "image[]=@./ref2.png" PENTING: /images/generations TIDAK menerima gambar masukan. Kirim gambar ke /images/edits, bukan ke /images/generations.
Model yang belum mengaktifkan endpoint edit hanya melayani /images/generations.
Decision model (System One)
Model decision menjawab pertanyaan bertipe dan mengembalikan keputusan terstruktur beserta probabilitas — bukan teks. Bentuk request & responsnya BERBEDA dari OpenAI, jadi punya endpoint sendiri.
Tiga tipe pertanyaan; semuanya bisa digabung dalam satu request (dinilai paralel):
noul— pertanyaan ya/tidak; menjawab peluang "ya" (0–1).choice— memilih satu dari daftar opsi; menjawab pilihan, probabilitas tiap opsi, dan confidence.score— menilai pada rubrik berjenjang; menjawab skor, probabilitas tiap tingkat, dan confidence.
Kode model decision ada di katalog (mis. typesafe/jev-1.13).
Alias: endpoint ini juga tersedia di /decisions — nama yang dipakai sebagian perantara. Keduanya menuju layanan yang sama; pilih yang cocok dengan kode Anda.
Contoh — tiga pertanyaan sekaligus dalam satu request:
curl <alamat-situs-anda>/v1/systemone \
-H "Authorization: Bearer sk-kiyara-..." \
-H "Content-Type: application/json" \
-d '{
"state": "Payout saya gagal 3 hari berturut-turut, saya kehilangan penjualan!",
"model": "typesafe/jev-1.13",
"questions": {
"is_urgent": {
"type": "noul",
"instructions": "Apakah pesan ini menunjukkan urgensi?"
},
"department": {
"type": "choice",
"instructions": "Tim mana yang harus menangani ini",
"criteria": {
"billing": "Masalah pembayaran atau langganan",
"technical": "Bug atau masalah integrasi",
"sales": "Harga atau pertanyaan akun"
}
},
"frustration": {
"type": "score",
"instructions": "Seberapa frustrasi pelanggan ini",
"criteria": ["Tenang", "Frustrasi tapi sopan", "Sangat marah"]
}
}
}' Responsnya berisi satu jawaban per pertanyaan, memakai kunci yang Anda tentukan sendiri:
{
"model": "jev-1.13.0",
"answers": {
"is_urgent": { "type": "noul", "noul": 0.92 },
"department": {
"type": "choice",
"choice": "billing",
"probabilities": { "billing": 0.94, "technical": 0.06, "sales": 0.0 },
"confidence": 0.91
},
"frustration": {
"type": "score",
"score": 1.52,
"legend": { "0": "Tenang", "1": "Frustrasi tapi sopan", "2": "Sangat marah" },
"probabilities": { "0": 0.0, "1": 0.47, "2": 0.53 },
"confidence": 0.29
}
},
"usage": { "input_tokens": 401, "output_tokens": 73 }
} Penagihan: model ini ditagih per token INPUT saja — token output gratis.
PENTING: endpoint ini TIDAK mendukung streaming. Kirim tanpa field "stream"; menyertakannya akan ditolak dengan pesan yang menjelaskan.
Kode error umum
| 401 | API key tidak valid / sudah dicabut. |
| 402 | Saldo tidak mencukupi — top-up atau aktifkan paket. |
| 404 | Model tidak ditemukan (cek kode model). |
| 429 | Batas laju / kuota harian tercapai — coba lagi nanti. |
| 503 | Model sedang tidak tersedia (maintenance/upstream down). |
