Langsung ke konten utama

​
AI API dalam aplikasi

Aplikasi Kazzle harus menggunakan AI API Kazzle untuk chat, gambar, speech, transkripsi, dan video. Jangan minta pengguna untuk kunci OpenAI, Anthropic, atau penyedia lain kecuali mereka secara khusus ingin menagih penyedia tersebut langsung.

​
Apa yang digunakan

Semua panggilan AI aplikasi melalui https://api.kazzle.app ditambah kunci API kzl_: 
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 adalah kredensial aplikasi yang Anda buat dengan tool api_key, simpan di vault, dan hubungkan ke komponen proses aplikasi.

​
Endpoint umum

TugasEndpoint
Chat atau generasi teksPOST /ai/chat/completions
GambarPOST /ai/images/generations
Teks ke speechPOST /ai/audio/speech
Speech ke teksPOST /ai/audio/transcriptions
Generasi videoPOST /ai/video/generations
Katalog modelGET /ai/models
Baca /ai/models terlebih dahulu ketika aplikasi perlu memilih model secara dinamis.

​
Menghubungkan kunci API

  1. Buat kunci API Kazzle yang dibatasi untuk aplikasi.
  2. Simpan di koleksi rahasia + lingkungan dengan nama KAZZLE_API_KEY (nama rahasia menjadi kunci variabel env).
  3. Arahkan komponen proses ke koleksi + lingkungan tersebut.
  4. Pertahankan panggilan di sisi server kecuali endpoint sengaja publik melalui backend Anda sendiri.
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Proses server akan melihat process.env.KAZZLE_API_KEY diselesaikan dari vault saat runtime. Tidak ada field env.vars — rahasia hanya mencapai komponen aplikasi melalui koleksi + lingkungan yang mereka tunjuk. Jangan pernah letakkan kunci API pribadi dalam kode frontend atau variabel VITE_*.