> ## 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 en aplicaciones

> Integra la API de IA de Kazzle en un componente de aplicación.

# IA en aplicaciones

Las aplicaciones acceden a IA (chat, imágenes, voz, transcripción, vídeo) a través de la **API de IA de Kazzle** — un único endpoint, facturado en créditos contra el espacio. No pidas a los usuarios claves de OpenAI/Anthropic/otros proveedores a menos que específicamente quieran facturar esos proveedores directamente.

Los endpoints, facturación y ejemplos están documentados una sola vez en la [referencia de API de IA](/platform/ai-api). Esta página solo cubre cómo integrarla en una aplicación.

## Integración de la clave API

1. Crea una clave de API de Kazzle con alcance para la aplicación usando la herramienta `api_key`.
2. Guárdala en una colección de secretos + entorno con el nombre `KAZZLE_API_KEY` (el nombre del secreto se convierte en la variable de entorno).
3. Apunta el componente de proceso a esa colección + entorno.
4. Llama a `https://api.kazzle.app/ai/*` solo desde código del lado del servidor.

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

En tiempo de ejecución el proceso ve `process.env.KAZZLE_API_KEY`, resuelto desde el vault. No hay campo `env.vars` — los secretos llegan a los componentes solo a través de la colección + entorno a la que apuntan.

```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 pongas la clave en código frontend o en una variable `VITE_*`. Consulta [Secretos](/apps/secrets) para la integración del vault y [referencia de API de IA](/platform/ai-api) para cada endpoint.