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

# IA em apps

> Integre a API de IA do Kazzle em um componente de app.

# IA em apps

Apps obtêm IA (chat, imagens, fala, transcrição, vídeo) através da **API de IA do Kazzle** — um único endpoint, faturado em créditos contra o espaço. Não peça aos usuários chaves do OpenAI/Anthropic/outros provedores a menos que eles especificamente queiram faturar esses provedores diretamente.

Os endpoints, faturamento e exemplos estão documentados uma única vez na [referência da API de IA](/platform/ai-api). Esta página cobre apenas como integrá-la em um app.

## Integrando a chave da API

1. Crie uma chave de API do Kazzle com escopo para o app usando a ferramenta `api_key`.
2. Armazene-a em uma coleção de segredos + ambiente com o nome `KAZZLE_API_KEY` (o nome do segredo se torna a variável de ambiente).
3. Aponte o componente de processo para essa coleção + ambiente.
4. Chame `https://api.kazzle.app/ai/*` apenas a partir de código no servidor.

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

Em tempo de execução, o processo vê `process.env.KAZZLE_API_KEY`, resolvido do cofre. Não há campo `env.vars` — segredos chegam aos componentes apenas através da coleção + ambiente que apontam para.

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

Nunca coloque a chave em código frontend ou em uma variável `VITE_*`. Veja [Segredos](/apps/secrets) para a integração do cofre e [referência da API de IA](/platform/ai-api) para cada endpoint.