> ## 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.

# L'IA dans les apps

> Intégrez l'API IA Kazzle dans un composant d'app.

# L'IA dans les apps

Les apps accèdent à l'IA (chat, images, parole, transcription, vidéo) via l'**API IA Kazzle** — un seul endpoint, facturé en crédits sur l'espace. Ne demandez pas aux utilisateurs leurs clés OpenAI/Anthropic/autres fournisseurs sauf s'ils veulent spécifiquement facturer ces fournisseurs directement.

Les endpoints, la facturation et les exemples sont documentés une seule fois dans la [référence API IA](/platform/ai-api). Cette page couvre uniquement l'intégration dans une app.

## Intégrer la clé API

1. Créez une clé API Kazzle limitée pour l'app avec l'outil `api_key`.
2. Stockez-la dans une collection de secrets + environnement sous le nom `KAZZLE_API_KEY` (le nom du secret devient la variable d'env).
3. Pointez le composant process vers cette collection + environnement.
4. Appelez `https://api.kazzle.app/ai/*` uniquement depuis du code côté serveur.

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

À l'exécution, le process voit `process.env.KAZZLE_API_KEY`, résolu depuis le vault. Il n'y a pas de champ `env.vars` — les secrets atteignent les composants uniquement via la collection + environnement qu'ils pointent.

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

Ne mettez jamais la clé dans du code frontend ou une variable `VITE_*`. Consultez [Secrets](/apps/secrets) pour l'intégration du vault et [référence API IA](/platform/ai-api) pour chaque endpoint.