Panduan mulai cepat

Kunavo adalah gateway API AI independen yang kompatibel dengan OpenAI: satu kunci API dan satu saldo bayar sesuai pemakaian memungkinkan Anda mengakses model Claude, GPT, serta model gambar, video, dan audio, tanpa memerlukan akun terpisah untuk setiap penyedia. Seluruh proses orientasi terdiri dari empat langkah. Tiga langkah pertama hanya perlu dilakukan sekali. Langkah keempat — melakukan panggilan — cukup dengan mengganti base_url.

1. Buat akun

Daftar di kunavo.com/app/login menggunakan Google atau tautan masuk melalui email. Pembayaran dilakukan sesuai pemakaian dan dimulai dengan pengisian saldo sebesar $10 — saldo Anda tidak pernah kedaluwarsa, dan permintaan yang gagal tidak pernah dikenai biaya.

2. Buat kunci API

Buka /app/keys di dasbor, lalu klik Kunci baru. Kunci diawali dengan sk-kn- dan hanya ditampilkan satu kali saat dibuat — salin dan simpan dengan aman.

Praktik keamanan yang disarankan:

• Gunakan satu kunci untuk setiap proyek/lingkungan (dev, staging, prod).
• Ganti kunci jika terjadi insiden atau setiap tiga bulan.
• Tetapkan batas pengeluaran bulanan per kunci jika Anda menjalankan skrip panggilan dari CI.

3. Isi saldo dompet

Buka /app/billing dan isi saldo melalui Stripe Checkout. Kartu ditawarkan di semua wilayah yang dijangkau Stripe, dan Apple Pay, Google Pay, serta Link di semua wilayah kecuali India; metode lokal muncul berdasarkan negara — misalnya ACH di AS, Pix di Brasil, UPI di India, KakaoPay di Korea Selatan, iDEAL di Belanda, dan BLIK di Polandia (daftar lengkapnya ada dalam referensi penagihan; PayPal dan SEPA Direct Debit tidak ditawarkan). Pengisian saldo dimulai dari $10 — cukup untuk mencoba setiap model dengan kunci nyata — dan saldo tidak pernah kedaluwarsa.

• Pembayaran sesuai pemakaian: biaya penggunaan dipotong dari saldo dompet Anda secara real time, tanpa langganan.
• Bonus volume berlaku: $100 → +$10, $1,000 → +$200, $5,000 → +$1,250.
• Deskripsi transaksi pada kartu Anda: KUNAVO.COM* TOPUP.

4. Lakukan panggilan pertama

Pilih model apa pun yang diaktifkan dari katalog. Berikut contoh panggilan chat claude-haiku-4-5 yang murah dan cepat untuk memverifikasi konfigurasi.

Python (SDK OpenAI)

Paket Python openai (v1+) dapat langsung digunakan — cukup arahkan base_url ke Kunavo.

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",
)

resp = client.chat.completions.create(
    model="claude-haiku-4-5",
    messages=[{"role": "user", "content": "Say hi in one sentence."}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-haiku-4-5",
  messages: [{ role: "user", content: "Say hi in one sentence." }],
});
console.log(resp.choices[0].message.content);

curl

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "messages": [{"role": "user", "content": "Say hi in one sentence."}]
  }'

Modalitas lainnya

SDK yang sama mendukung gambar dan video. Jika memungkinkan, nama endpoint mengikuti penamaan OpenAI.

Pembuatan gambar

Gunakan model gambar apa pun — Nano Banana, Nano Banana 2, Nano Banana Pro, dan GPT-Image-2. Lihat dokumentasi gambar.

img = client.images.generate(
    model="nano-banana",
    prompt="a tiny red origami crane on a white desk",
    size="1024x1024",
)
print(img.data[0].url)

Chat streaming

Atur stream=True. Streaming berfungsi pada setiap model chat — seluruh keluarga Claude dan GPT. Respons dikirim sebagai peristiwa yang dikirim server (SSE) dalam format standar OpenAI.

stream = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Tell me a 2-line haiku about CI/CD."}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Langkah selanjutnya

1. Autentikasi — referensi lengkap kunci API + URL dasar.
2. Chat completions — parameter, streaming, pemanggilan alat, visi.
3. Penagihan — cara kerja rumus markup dan buku besar kredit.
4. Kesalahan — kode HTTP dan strategi percobaan ulang.