Kiyararouter
Kembali ke beranda

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>/v1

Autentikasi

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.temperatureKreativitas model (0–2).
kiyara.maxTokensBatas token output; 0 = biarkan server menentukan.
kiyara.systemPromptSystem prompt default untuk setiap percakapan.
kiyara.defaultMaxInputTokensCadangan batas konteks bila metadata katalog tidak tersedia.
kiyara.defaultMaxOutputTokensCadangan batas output bila konteks belum diketahui.
kiyara.modelAllowListBila diisi, hanya model dalam daftar ini yang dimunculkan di pemilih model.
kiyara.visionModelsPaksa deteksi kemampuan gambar. Isi kode model untuk memaksa vision; beri awalan "-" untuk memaksa non-vision.
kiyara.debugLog 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

401API key tidak valid / sudah dicabut.
402Saldo tidak mencukupi — top-up atau aktifkan paket.
404Model tidak ditemukan (cek kode model).
429Batas laju / kuota harian tercapai — coba lagi nanti.
503Model sedang tidak tersedia (maintenance/upstream down).