Dokümantasyon

Faturalandırma

Ön ödemeli cüzdandan kullandıkça ödeyin. Her çağrı mikro sent düzeyinde ölçülür ve değiştirilemez bir deftere kaydedilir. Abonelik yoktur, taahhüt yoktur; bakiyenin süresi dolmaz.

Stripe üzerinden bakiye yükleyin → tutar cüzdanınıza eklenir → her API çağrısının maliyeti gerçek zamanlı olarak bakiyeden düşülür. Bakiyeniz sıfıra inerse yeniden yükleme yapana kadar çağrılar 402 insufficient_quota yanıtı verir.

Fiyatlandırma modeli

Her çağrı için Kunavo, kullanıcı maliyetini iki değerden büyük olanı olarak hesaplar:

user_cost = max(catalog_cost, upstream_cost × markup_factor)

Katalog maliyeti — model kartında gösterilen fiyat (1 milyon belirteç başına, görüntü başına, saniye başına video vb.) × gerçek kullanım birimleri.
Üst sağlayıcı maliyeti — üst sağlayıcının belirli çağrı için Kunavo'dan aldığı ücret; kredi cinsinden ifade edilir ve 1 kredi = $0.005'tir.
Fiyat artış katsayısı — genellikle 1.5 (üst sağlayıcı maliyetine %50 eklenir). Üst sağlayıcının toptan satış fiyatının sağlayıcının resmî fiyatına daha yakın olduğu bazı Çinli sağlayıcı modellerinde, resmî fiyatın altında kalmak için katsayı 1.2 olarak düşürülür.

max() işlevi şunları sağlar: (a) reklamı yapılan katalog fiyatından daha az ödemezsiniz ve (b) üst sağlayıcı maliyetinin beklenmedik biçimde arttığı bir çağrıda zarar etmeyiz.

Kipliğe göre faturalandırma birimleri

Modalite	Birim	Ayrıntı düzeyi
Sohbet	1 milyon girdi belirteci başına + 1 milyon çıktı belirteci başına	Token düzeyinde kesin; akıl yürütme token'ları çıktı tarifesi üzerinden ücretlendirilir.
Görüntü (t2i / düzenleme)	görüntü başına	Oluşturulan görüntü başına; kısmi üretimler ücretlendirilmez.
Video	video başına	Çözünürlük kademesine göre belirlenen, klip başına sabit fiyat.

Uzun istemler, sağlayıcının uzun bağlam kademesine göre ücretlendirilir. GPT-5.5, GPT-5.6 Sol ve Terra ile GPT-6 Astra modellerinde, 272K'tan fazla girdi belirteci içeren bir istem, isteğin tamamının girdi ücretinin 2× — önbellek okumaları ve yazmaları da dahil — ve çıktı ücretinin 1.5× üzerinden, OpenAI'nin yayımladığı kademeye göre hesaplanmasına yol açar. Claude'da uzun bağlam ek ücreti yoktur: 1M bağlam standart tarife üzerinden ücretlendirilir.

Önbelleğe alınan belirteçler

Sohbet modelleri, istemlerin sabit öneklerini önbelleğe alır. Önbellek okumaları normal girdi ücretinden çok daha düşük bir ücretle hesaplanır — Claude ve OpenAI modellerinde 0.10×, ve 0.025× on Claude Fable 5.1, 0.05× on Claude Opus 5.5. Önbellek yazmaları, 1 saatlik TTL yazmaları dahil her Claude modelinde girdi ücretine 1.25× çarpanı uygulanarak hesaplanır (bu çarpan Anthropic'in 2× çarpanından düşüktür); GPT-5.6 Sol, Terra ve Luna ile GPT-6 Astra modellerinde de aynı ücret uygulanır. Diğer tüm modellerde yazmalar normal girdi ücreti üzerinden hesaplanır. Her sınıfa modelin kendi indirimi uygulanır; bu nedenle önbellek fiyatları, sağlayıcının liste fiyatına kıyasla girdi ve çıktı fiyatlarıyla aynı indirim oranını taşır. Yukarıdaki max() taban fiyatı, önbellek dikkate alınarak hesaplanır; böylece indirim katalog fiyatı tarafından silinmeden size yansır.

Fiyatlandırma tablosunun tamamını görmek, cache_control ayarının nasıl etkinleştirileceğini ve Kunavo'nun yakınlık yönlendirmesinin önbelleği nasıl sıcak tuttuğunu öğrenmek için İstem önbelleğe alma kılavuzuna bakın.

Hassasiyet

Kunavo'daki tüm tutarlar micro_cents cinsinden saklanır:

1 USD = 100,000,000 micro_cents
1 cent = 1,000,000 micro_cents
Hesaplanabilen en düşük ücret: 0.0001 cent ($0.000001). Pratikte sohbet çağrılarının ücreti çoğu zaman bu taban tutar üzerinden hesaplanır.

Küçük tutarlar kontrol panelinde USD cinsinden 6 ondalık basamağa, 1 senti aşan tutarlar ise 2 ondalık basamağa yuvarlanarak gösterilir. Dahili muhasebe kesindir.

Bakiye yükleme

Stripe Checkout üzerinden /app/billing adresinde bakiyenizi yükleyin: Stripe'ın ulaştığı her yerde kartlar (Visa, Mastercard, Amex, JCB, UnionPay); Hindistan hariç her yerde Apple Pay, Google Pay ve Link. Ülkeye bağlı yöntemler alıcının kendi pazarında görünür: Amerika Birleşik Devletleri'nde Cash App Pay, Klarna, Afterpay, ACH ile banka hesabından tahsilat (3–5 iş gününde sonuçlanır) ve kripto (stablecoin'ler); ayrıca $100 ve üzeri yüklemelerde Affirm ve $100 ile $1,500 arasındaki yüklemelerde Zip; Çin ana karasında Alipay ve WeChat Pay; Güney Kore'de KakaoPay, Naver Pay, PAYCO, Samsung Pay ve Kore yerel kartları; Hindistan'da UPI; Brezilya'da Pix; Hollanda'da iDEAL, Belçika'da Bancontact, Avusturya'da EPS, Portekiz'de MB WAY ve İtalya'da Satispay; Polonya'da BLIK; Birleşik Krallık'ta Bacs Direct Debit; Birleşik Krallık, İrlanda ve Finlandiya'daki alıcılar için Pay by Bank.

Yüklemeler USD cinsinden fiyatlandırılır ve Stripe dönüşüm yapar. Ödeme sayfası tutarı kendi para biriminizde gösterir ve işlemi o para biriminde tamamlar — Pix'in reallerle, BLIK'in złoty ile dolar fiyatına karşılık ücretlendirilmesi bu şekilde olur. Stripe'ın dönüşüm kuru, alıcının ödediği %2–4'lük bir ücret içerir (Stripe Adaptive Pricing belgeleri, 2026-10-03 tarihinde okunmuştur); USD ile ödeme bu ücreti önler, ancak yerel ödeme yöntemleri yerel para birimini gerektirir. Bu kapsamın dışında SEPA Direct Debit vardır: hesabımızda etkin yöntemler arasında değildir, bu yüzden hiçbir zaman görünmez ve hiçbir para birimi ayarı bunu değiştirmez. SEPA ülkelerinde düzenlenmiş her kart normal şekilde çalışır; buna SEPA hesabına bağlı bir banka kartı da dahildir.

Kademe fiyatlandırması

Bakiye yükleme	Sunduğumuz özellikler	Bonus
$10	$10.00	—
$100	$110.00	+$10 (10%)
$1,000	$1,200.00	+$200 (20%)
$5,000	$6,250.00	+$1,250 (25%)

Bakiye süresi dolmaz. Bir kez yükleyip aylar içinde tüketebilirsiniz. Ayrıca /app/keys'den her API anahtarı için aylık harcama limiti belirleyerek tek bir iş yüküne kesin bir üst sınır koyabilirsiniz: ilgili anahtarın takvim ayındaki harcaması belirlediğiniz tutarı aşacaksa çağrılar 402 insufficient_quota yanıtıyla reddedilir ve ücret alınmaz. Diğer anahtarlarınız çalışmaya devam eder. Aynı ekranda her anahtar için IP izin listesi de ayarlanabilir — başka yerlerden gelen çağrılar 403 alır.

Otomatik bakiye yükleme

İsteğe bağlı. /app/billing'de bir kartı bir kez kaydedin ve üç sayı belirleyin: bakiyenin altına düştüğünde yükleme yapılacak eşik değeri, her seferinde eklenecek tutar ve aylık üst sınır. Bundan sonra cüzdanınız otomatik olarak yeniden doldurulur — bakiyeyi eşiğinizin altına düşüren bir hesaplaşmanın ardından saniyeler içinde ve bu sırada bakiye yetersizliği nedeniyle bir istek reddedilirse o isteğe yanıt verilmeden önce — böylece gözetimsiz bir ajan 402 nedeniyle durmaz.

Ayar	Aralık	Notlar
Altına düşünce tetiklenir	$5 – $1,000	En büyük tek isteğinizden yüksek bir değer belirleyin.
Her seferinde eklenecek tutar	$10 – $1,000, tam dolar cinsinden	$100 ve $1.000, manuel bakiye yüklemeyle aynı bonusu taşır; diğer tutarlar herhangi bir bonus taşımaz.
Aylık üst sınır	tutar – $20,000	Bonus hariç, her takvim ayında sizden tahsil edilen tutarları sayar.

Kartlar veya Link. Alipay, WeChat Pay, Pix ve diğer yerel ve banka yöntemlerinden otomatik olarak tahsilat yapılamaz; bu nedenle otomatik yükleme, normalde bunlarla ödeme yapsanız bile bir kart veya kart tutan bir Link hesabı gerektirir. Günde en fazla beş tahsilat yapılır; art arda üç ret işlemi duraklatır ve size e-posta gönderir; kartın kaldırılması, itiraz veya dolandırıcılık engeli işlemi hemen durdurur. Her tahsilatta makbuz gönderilir ve ekstrede KUNAVO* AUTOTOPUP görünür.

Bakiye yükleme sürerken reddedilen bir istek 402 ve Retry-After: 3 ile yanıtlanır; diğer tüm retler sonraki adımda ne yapmanız gerektiğini belirtir. Aynı sayfadan otomatik yüklemeyi istediğiniz zaman kapatabilir veya belirlediğiniz sayısal değerleri değiştirebilirsiniz.

Webhook zamanlaması

Stripe Checkout işlemini tamamladıktan sonra bakiyeniz webhook üzerinden güncellenir. Webhook genellikle ödeme onayından sonra 5–10 saniye içinde tetiklenir. Kart ödemelerinde bu güncelleme neredeyse anında gerçekleşir; yalnızca asenkron onay veren bir ödeme yönteminin kesinleşmesi günler sürebilir. Bu siparişler para ulaşana kadar processing olarak görünür; kesinleşme webhook'u geldiğinde cüzdana kredi eklenir — yeniden ödeme yapmanız gerekmez ve bu sırada hiçbir şeyin süresi dolmaz. Hiç tamamlanmayan bir sipariş pending olarak görünür; temizleme işi 24 saat sonra etiketini expired olarak değiştirir. Bu etiket yalnızca görseldir ve hiçbir şeyi iptal etmez.

Kredi defteri

Bakiyedeki her değişiklik, yalnızca yeni kayıt eklenebilen bir deftere kaydedilir:

Tür	Yön	Ne zaman
topup	kredi (+)	Stripe ödemesi onaylandı.
consume	borç (−)	API çağrısı tamamlandığında ücretlendirilir.
refund	kredi (+)	Stripe para iadesi veya yönetici tarafından elle kredi ekleme.
manual_adjust	kredi (+/−)	Operatör düzeltmesi (ör. olay nedeniyle para iadesi).

Her satıra balance_after_micro_cents damgası eklenir ve böylece her olayın anlık görüntüsü sunulur. Tam geçmişi /app/billing'de görüntüleyin.

Kullanım günlükleri

Her API çağrısı usage_logs içinde bir satır oluşturur:

Model, durum (başarılı / hata), HTTP durum kodu
Girdi / çıktı token'ları, önbellekten sunulan + önbelleğe yazılan token'lar, görsel sayısı, saniye, karakter
upstream_cost_micro_cents — Kunavo'nun üst sağlayıcıya ödediği tutar
cost_micro_cents — sizin ödediğiniz tutar (marj eklendikten sonra)
Gecikme, istek IP'si, kullanıcı aracısı, API anahtarı öneki

Filtreler ve çağrı başına ayrıntı sayfalarıyla /app/usage adresinde görüntülenir.

Başarısız çağrılar — bunlar ücretlendirilir mi?

Hayır. Kunavo yalnızca status = success olduğunda ücret alır. Üst sağlayıcı 4xx / 5xx döndürürse veya görevimiz zaman aşımına uğrarsa çağrı kaydedilir, ancak maliyet $0. Üst sağlayıcı maliyetini size yansıtmak yerine kendimiz karşılarız.

Para iadeleri

Para iadeleri, support@kunavo.com üzerinden duruma göre değerlendirilir. İade ettiğimiz yaygın durumlar:

Kunavo tarafındaki bir kesintinin bütçenizi kaybetmenize yol açması.
Görüntülenen kataloğa kıyasla fazla ücret alınmasına yol açan fiyatlandırma hataları.
Stripe üzerinden yanlışlıkla iki kez bakiye yükleme.

Para iadeleri varsayılan olarak cüzdanınıza kredi olarak yapılır; talep üzerine Stripe üzerinden banka hesabına iade de mümkündür.