Hızlı başlangıç

Kunavo, bağımsız ve OpenAI uyumlu bir AI API ağ geçididir: Tek bir API anahtarı ve kullandıkça öde bakiyesiyle Claude, GPT ve görüntü, video ve ses modellerine, sağlayıcı başına hesap gerekmeksizin erişebilirsiniz. Tüm başlangıç süreci dört adımdan oluşur. İlk üç adım bir kez yapılır. Dördüncü adım — çağrı yapmak — yalnızca bir base_url değişikliğidir.

1. Hesap oluşturun

Google veya e-posta sihirli bağlantısıyla kunavo.com/app/login adresinden kaydolun. Kullandıkça öde modeliyle çalışır ve 10 $ yüklemeyle başlar — bakiyenizin süresi asla dolmaz ve başarısız istekler için hiçbir zaman ücret alınmaz.

2. API anahtarı oluşturun

Kontrol panelinde /app/keys bölümünü açın ve Yeni anahtar'a tıklayın. Anahtarlar sk-kn- ile başlar ve oluşturulurken yalnızca bir kez gösterilir — kopyalayıp güvenli bir yerde saklayın.

Önerilen güvenlik önlemleri:

• Her proje/ortam (geliştirme, hazırlık, üretim) için ayrı bir anahtar kullanın.
• Bir güvenlik olayı yaşandığında veya üç ayda bir anahtarları yenileyin.
• CI üzerinden betiklerle çağrı yapıyorsanız her anahtar için aylık harcama sınırı belirleyin.

3. Cüzdanınıza bakiye yükleyin

/app/billing adresine gidin ve Stripe Checkout üzerinden yükleme yapın. Stripe'ın hizmet verdiği her yerde kartlar, Hindistan hariç her yerde Apple Pay, Google Pay ve Link sunulur; ülkeye göre yerel yöntemler görünür — örneğin ABD'de ACH, Brezilya'da Pix, Hindistan'da UPI, Güney Kore'de KakaoPay, Hollanda'da iDEAL ve Polonya'da BLIK (tam liste faturalandırma referansında yer alır; PayPal ve SEPA Otomatik Ödeme sunulmaz). Yüklemeler $10 tutarından başlar — gerçek bir anahtarla her modeli denemeye yeter — ve bakiye hiçbir zaman sona ermez.

• Kullandıkça öde: kullanım tutarı abonelik olmadan cüzdanınızdan gerçek zamanlı olarak düşülür.
• Hacim bonusları uygulanır: $100 → +$10, $1,000 → +$200, $5,000 → +$1,250.
• Kart ekstrenizde görünen işyeri adı: KUNAVO.COM* TOPUP.

4. İlk çağrınızı yapın

katalogdan etkinleştirilmiş herhangi bir modeli seçin. Aşağıda bağlantının doğru çalıştığını doğrulayabileceğiniz, ucuz ve hızlı bir claude-haiku-4-5 sohbet çağrısı yer alıyor.

Python (OpenAI SDK)

openai Python paketi (v1+) ek ayar gerektirmeden çalışır — base_url'i Kunavo'ya yönlendirmeniz yeterlidir.

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."}]
  }'

Diğer kipler

Aynı SDK görüntü ve video işlemlerini de destekler. Uç noktalar, mümkün olduğunda OpenAI adlandırmasını kullanır.

Görüntü oluşturma

Nano Banana, Nano Banana 2, Nano Banana Pro ve GPT-Image-2 dahil tüm görüntü modellerini kullanabilirsiniz. Görüntü belgelerine bakın.

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

Akışlı sohbet

stream=True ayarını kullanın. Akış, Claude ve GPT ailelerinin tümü dahil olmak üzere her sohbet modelinde çalışır. Yanıt, OpenAI'nin standart biçiminde sunucu tarafından gönderilen olaylardan oluşur.

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)

Sonraki adımlar

1. Kimlik doğrulama — API anahtarı ve temel URL için kapsamlı başvuru.
2. Sohbet tamamlamaları — parametreler, akış, araç çağrıları ve görsel anlama.
3. Faturalandırma — marj formülünün ve kredi defterinin işleyişi.
4. Hatalar — HTTP kodları ve yeniden deneme stratejisi.