> ## 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 in Apps

> Kazzle AI API in eine App-Komponente integrieren.

# AI in Apps

Apps erhalten AI (Chat, Bilder, Sprache, Transkription, Video) über die **Kazzle AI API** — ein Endpoint, abgerechnet in Credits gegen den Space. Fordern Sie Benutzer nicht auf, OpenAI-/Anthropic-/andere Provider-Schlüssel anzugeben, es sei denn, sie möchten diese Provider direkt abrechnen.

Die Endpoints, Abrechnung und Beispiele sind einmalig in der [AI API-Referenz](/platform/ai-api) dokumentiert. Diese Seite behandelt nur die Integration in eine App.

## API-Schlüssel integrieren

1. Erstellen Sie einen scoped Kazzle API-Schlüssel für die App mit dem `api_key`-Tool.
2. Speichern Sie ihn in einer Secret-Collection + Umgebung unter dem Namen `KAZZLE_API_KEY` (der Secret-Name wird zur Umgebungsvariable).
3. Verweisen Sie die Process-Komponente auf diese Collection + Umgebung.
4. Rufen Sie `https://api.kazzle.app/ai/*` nur aus serverseitigem Code auf.

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

Zur Laufzeit sieht der Process `process.env.KAZZLE_API_KEY`, aufgelöst aus dem Vault. Es gibt kein `env.vars`-Feld — Secrets erreichen Komponenten nur über die Collection + Umgebung, auf die sie verweisen.

```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,
});
```

Platzieren Sie den Schlüssel niemals in Frontend-Code oder einer `VITE_*`-Variable. Siehe [Secrets](/apps/secrets) für die Vault-Integration und [AI API-Referenz](/platform/ai-api) für jeden Endpoint.