> ## 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 nelle app

> Integra l'API Kazzle AI in un componente app.

# AI nelle app

Le app accedono all'AI (chat, immagini, sintesi vocale, trascrizione, video) tramite l'**API Kazzle AI** — un unico endpoint, fatturato in crediti a carico dello spazio. Non chiedere agli utenti le chiavi di OpenAI/Anthropic/altri provider a meno che non vogliano fatturare direttamente a quei provider.

Gli endpoint, la fatturazione e gli esempi sono documentati una sola volta nel [riferimento API AI](/platform/ai-api). Questa pagina copre solo l'integrazione in un'app.

## Integrazione della chiave API

1. Crea una chiave API Kazzle con ambito per l'app usando lo strumento `api_key`.
2. Memorizzala in una raccolta di segreti + ambiente con il nome `KAZZLE_API_KEY` (il nome del segreto diventa la variabile d'ambiente).
3. Punta il componente process a quella raccolta + ambiente.
4. Chiama `https://api.kazzle.app/ai/*` solo da codice lato server.

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

A runtime il process vede `process.env.KAZZLE_API_KEY`, risolto dal vault. Non esiste un campo `env.vars` — i segreti raggiungono i componenti solo tramite la raccolta + ambiente a cui puntano.

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

Non mettere mai la chiave in codice frontend o in una variabile `VITE_*`. Vedi [Segreti](/apps/secrets) per l'integrazione del vault e [riferimento API AI](/platform/ai-api) per ogni endpoint.