> ## 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 в приложениях

> Подключите Kazzle AI API к компоненту приложения.

# AI в приложениях

Приложения получают AI (чат, изображения, речь, транскрипция, видео) через **Kazzle AI API** — один endpoint, оплачиваемый кредитами в рамках пространства. Не просите пользователей предоставлять ключи OpenAI/Anthropic/других провайдеров, если они специально не хотят оплачивать эти провайдеры напрямую.

Endpoints, оплата и примеры документированы один раз в [справочнике AI API](/platform/ai-api). На этой странице рассматривается только подключение к приложению.

## Подключение ключа API

1. Создайте scoped Kazzle API ключ для приложения с помощью инструмента `api_key`.
2. Сохраните его в коллекции секретов + окружение с именем `KAZZLE_API_KEY` (имя секрета становится переменной окружения).
3. Укажите компоненту process на эту коллекцию + окружение.
4. Вызывайте `https://api.kazzle.app/ai/*` только из серверного кода.

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

Во время выполнения процесс видит `process.env.KAZZLE_API_KEY`, разрешённый из хранилища. Нет поля `env.vars` — секреты попадают в компоненты только через коллекцию + окружение, на которые они указывают.

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

Никогда не помещайте ключ в код фронтенда или переменную `VITE_*`. Подробнее о подключении хранилища см. в разделе [Секреты](/apps/secrets), а все endpoints описаны в [справочнике AI API](/platform/ai-api).