Ana içeriğe atla
Kazzle AI API, desteklediğimiz herhangi bir modeli çağırmak için tek bir kimliği doğrulanmış uç nokta sunar. Kredilerde bir kez ödeme yaparsınız, alanınıza karşı — OpenAI, Anthropic, Cloudflare Workers AI veya yönlendirdiğimiz başka hiçbir hizmet için ayrı hesaplara gerek yoktur. Tüm uç noktalar https://api.kazzle.app üzerinde /ai/* altında bulunur ve Authorization başlığında kzl_ API anahtarını kabul eder. Bir tane oluşturmak için API anahtarları bölümüne bakın. Oluşturulan Kazzle uygulamaları da bu API’yi kullanmalıdır. Uygulama için bir Kazzle API anahtarı oluşturun, kasada saklayın, bir işlem bileşeninde KAZZLE_API_KEY olarak bağlayın ve sunucu tarafı kodunuzdan https://api.kazzle.app/ai/* çağırın. Kullanıcılardan kendi sağlayıcı hesaplarını kullanmak istemedikçe sağlayıcı anahtarları istemeyin.

​
Yetenekler

Uç NoktaModaliteStandartlaştırılmış GirişStandartlaştırılmış Çıkış
POST /ai/chat/completionsSohbet (metin, akış)OpenAI uyumlu messages[]OpenAI uyumlu choices[] veya SSE akışı
POST /ai/responsesResponses APIOpenAI Responses uyumluOpenAI Responses uyumlu
POST /ai/images/generationsGörsel{ model, prompt, size?, output_format? }{ images: [{ url? | b64?, mimeType }] }
POST /ai/audio/speechMetinden konuşmaya{ model, text, voice?, format? }audio/* bayt akışı
POST /ai/audio/transcriptionsKonuşmadan metnemultipart/form-data ile file + model{ text }
POST /ai/video/generationsVideo (eşzamansız){ model, prompt, ... }{ id, status, pollUrl }
GET /ai/responses/{id}Eşzamansız yoklamayanıt idsağlayıcı şeklinde sonuç
POST /ai/gatewayHam geçişHerhangi bir Workers AI / sağlayıcı-yerel yükHam yukarı akış yanıtı
GET /ai/modelsKatalog—{ models: [{ id, modality, pricing, ... }] }
GET /ai/models, hangi model kimliklerinin hangi uç noktada çalıştığının gerçek kaynağıdır. API’ye karşı oluşturuyorsanız önce bunu okuyun.

​
Bir çağrı nasıl çalışır

Her faturalandırılabilir çağrı beş aşamadan geçer. Bunların çoğunu görmezsiniz — başarısız çağrıları geri almak ve tam kullanımı raporlamak için sunucu tarafında izlenir.
AşamaNe Oldu
openİsteğinize bağlı bir faturalandırma olayı oluşturduk, ancak henüz yukarı akışı çağırmadık.
recordedYukarı akış sağlayıcısı yanıt verdi. Cloudflare AI Gateway’den bir günlük kimliğimiz var. Maliyet henüz bilinmiyor.
pricedCloudflare nihai maliyeti bildirdi. İşaretlememizi uyguladık ve kredi ücretini yazdık. Terminal.
failedYukarı akış çağrısı başarısız oldu veya 20 yeniden denemeden sonra maliyet alamadık. Müşteri ücretlendirilmez. Terminal.
syncedFiyatlandırılmış olay ölçüm sistemimize teslim edildi.
Her başarılı yanıt x-kazzle-ai-billing-event-id: airesp_... içerir — daha sonra isteği kullanım dışa aktarımlarıyla ilişkilendirmek istiyorsanız saklayın.

​
Faturalandırma ve İşaretleme

cloudflare_cost_usd × (1 + markup) ücretlendiririz. İşaretleme Ayarlar → Faturalandırma → Fiyatlandırma bölümünde yayınlanır. Cloudflare’nin $0 olarak fiyatlandırdığı çağrılar (ücretsiz Workers AI katmanı, promosyonlar) priced aşamasına sıfır maliyetle ulaşır ve hiçbir zaman faturalandırılmaz. Rezerv: bir çağrı yapmak için en az $0.50 eşdeğer krediye ihtiyacınız vardır. Çağrı bitene kadar bunu bakiyenize karşı tutarız, ardından gerçek maliyeti kapatırız.

​
Hatalar

DurumAnlamı
401Eksik veya geçersiz kzl_ API anahtarı.
402Rezerv için yetersiz krediler. Ayarlar → Faturalandırma bölümünde yenileyin.
4xx yukarı akıştanOlduğu gibi iletilir. Gövde sağlayıcının hatasını içerir. Müşteri ücretlendirilmez.
5xx yukarı akıştanOlduğu gibi iletilir. Müşteri ücretlendirilmez.

​
Örnek — görsel oluşturma

curl https://api.kazzle.app/ai/images/generations \
  -H "Authorization: Bearer kzl_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "a single red dot on white",
    "size": "1024x1024"
  }'

{
  "images": [
    { "url": "https://...", "mimeType": "image/png" }
  ]
}

​
Örnek — metinden konuşmaya

curl https://api.kazzle.app/ai/audio/speech \
  -H "Authorization: Bearer kzl_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/tts-1","text":"hello world","voice":"alloy","format":"mp3"}' \
  --output speech.mp3

​
Ayrıca bakın