Ana içeriğe atla

Uygulamalarda AI API

Kazzle uygulamaları sohbet, görüntü, konuşma, transkripsiyon ve video için Kazzle’ın AI API’sini kullanmalıdır. Kullanıcılardan OpenAI, Anthropic veya diğer sağlayıcı anahtarlarını istemeyiniz; ancak bu sağlayıcılara doğrudan faturalandırmak istemeleri durumunda isteyebilirsiniz.

Neleri kullanmalı

Tüm uygulama AI çağrıları https://api.kazzle.app üzerinden ve bir kzl_ API anahtarı ile yapılır:
const apiUrl = 'https://api.kazzle.app';
const apiKey = process.env.KAZZLE_API_KEY;

if (!apiKey) {
  throw new Error('KAZZLE_API_KEY is required');
}

const response = await fetch(`${apiUrl}/ai/audio/transcriptions`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${apiKey}` },
  body: formData,
});
KAZZLE_API_KEY, api_key aracı ile oluşturduğunuz, kasada sakladığınız ve uygulamanın işlem bileşenine bağladığınız bir uygulama kimlik bilgisidir.

Yaygın uç noktalar

İşUç nokta
Sohbet veya metin oluşturmaPOST /ai/chat/completions
GörüntülerPOST /ai/images/generations
Metinden konuşmayaPOST /ai/audio/speech
Konuşmadan metnePOST /ai/audio/transcriptions
Video oluşturmaPOST /ai/video/generations
Model kataloğuGET /ai/models
Uygulama dinamik olarak bir model seçmesi gerektiğinde önce /ai/models okuyunuz.

API anahtarını bağlama

  1. Uygulama için kapsamlı bir Kazzle API anahtarı oluşturunuz.
  2. Bunu KAZZLE_API_KEY adıyla bir gizli koleksiyon + ortamda saklayınız (gizli adı ortam değişkeni anahtarı olur).
  3. İşlem bileşenini bu koleksiyon + ortama yönlendiriniz.
  4. Uç nokta kendi arka ucunuz aracılığıyla kasıtlı olarak herkese açık olmadığı sürece çağrıları sunucu tarafında tutunuz.
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Sunucu işlemi çalışma zamanında kasadan çözümlenen process.env.KAZZLE_API_KEY değerini görecektir. env.vars alanı yoktur — gizli bilgiler yalnızca işaret ettikleri koleksiyon + ortam aracılığıyla uygulama bileşenlerine ulaşır. Asla özel bir API anahtarını ön uç koduna veya VITE_* değişkenine koymayınız.