> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI dalam aplikasi

> Integrasikan Kazzle AI API ke dalam komponen aplikasi.

# AI dalam aplikasi

Aplikasi mendapatkan AI (chat, gambar, suara, transkripsi, video) melalui **Kazzle AI API** — satu endpoint, ditagih dalam kredit terhadap space. Jangan minta pengguna untuk kunci OpenAI/Anthropic/penyedia lain kecuali mereka secara khusus ingin menagih penyedia tersebut secara langsung.

Endpoint, penagihan, dan contoh didokumentasikan sekali dalam [referensi AI API](/platform/ai-api). Halaman ini hanya mencakup cara mengintegrasikannya ke dalam aplikasi.

## Mengintegrasikan kunci API

1. Buat kunci Kazzle API berskop untuk aplikasi dengan alat `api_key`.
2. Simpan dalam koleksi rahasia + lingkungan dengan nama `KAZZLE_API_KEY` (nama rahasia menjadi variabel env).
3. Arahkan komponen proses ke koleksi + lingkungan tersebut.
4. Panggil `https://api.kazzle.app/ai/*` hanya dari kode sisi server.

```ts theme={"theme":"material-theme-darker"}
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: { collection: 'my-app', environment: 'default' },
    },
  ],
});
```

Saat runtime, proses melihat `process.env.KAZZLE_API_KEY`, yang diselesaikan dari vault. Tidak ada bidang `env.vars` — rahasia mencapai komponen hanya melalui koleksi + lingkungan yang mereka tunjuk.

```ts theme={"theme":"material-theme-darker"}
const apiKey = process.env.KAZZLE_API_KEY;
if (!apiKey) throw new Error('KAZZLE_API_KEY is required');

const res = await fetch('https://api.kazzle.app/ai/audio/transcriptions', {
  method: 'POST',
  headers: { Authorization: `Bearer ${apiKey}` },
  body: formData,
});
```

Jangan pernah letakkan kunci dalam kode frontend atau variabel `VITE_*`. Lihat [Rahasia](/apps/secrets) untuk wiring vault dan [referensi AI API](/platform/ai-api) untuk setiap endpoint.