Dokümantasyon

Kayıttan ilk token'a — beş dakikada.

Kunavo OpenAI wire protokolüne uyar. OpenAI SDK kullanıyorsanız, geçiş tek satır base_url değişimi. Ciddiyiz.

İlk çağrı

SDK'nızı Kunavo'ya yönlendirin.

OpenAI Python SDK olduğu gibi çalışır. base_url'ü ve /app/keys'den API anahtarınızı ayarlayın, mevcut chat/image/embedding kodunuz her sınır modelinde çalışmaya devam eder.

first_call.py

from openai import OpenAI

client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Hello, Kunavo"}],
)
print(resp.choices[0].message.content)

Referans

Bir konu seçin

Başlangıç

Quickstart

Kayıttan ilk API çağrısına 5 dakikadan kısa sürede.

Kimlik doğrulama

API anahtarları, base URL, header kuralları, anahtar rotasyonu için iyi pratikler.

Claude API key

Claude API anahtarı alın, Claude'u OpenAI SDK veya yerel Messages API ile çağırın; geçersiz anahtarın döndürdüğü hata kodları.

Gemini API key

Google AI Studio veya Kunavo üzerinden Gemini API anahtarı alın, OpenAI SDK ile çağırın ve paketin içine sızmasını önleyin.

Faturalandırma

Cüzdan yükleme, markup formülü, kredi defterinin nasıl işlediği.

Kullanım API'si

GET /v1/usage — API anahtarınızın günlük token kullanımını ve maliyetini sorgulayın.

Hatalar

HTTP durum kodları, hata payload formu, bütçeyi tüketmeyen retry stratejisi.

Endpoint'ler

Chat completions

Streaming, tools, vision, reasoning destekli OpenAI uyumlu /v1/chat/completions.

Messages API

Yerel Anthropic Messages API — cache_control, tools, thinking'i doğrudan Claude'a geçin.

Görseller

Metinden görsele ve görsel düzenleme (i2i) — Nano Banana ve GPT-Image-2.

Video

Veo 3 — Fast, Quality, Lite. Uzun çalışan görev API'si.

Music

Suno V5 — text-to-music with vocals, lyrics and styles. Async task API.

Rehberler

Prompt caching

Tekrarlanan prompt'larda Anthropic input maliyetini %90 azaltın — cache_control, affinity routing ve dashboard metrikleri birlikte nasıl çalışır.

Ollama OpenAI API

Call Ollama's local OpenAI-compatible API — and point the same SDK at hosted Claude, Gemini and GPT.

OpenAI'den göç

Yakında

OpenAI, Anthropic ve Google direct'ten drop-in göç rehberi.