> ## 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. Створіть обмежений ключ Kazzle API для додатка за допомогою інструменту `api_key`.
2. Збережіть його в колекції секретів + середовище під назвою `KAZZLE_API_KEY` (назва секрету стає змінною середовища).
3. Вкажіть компонент процесу на цю колекцію + середовище.
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) для підключення сховища та [довідку AI API](/platform/ai-api) для кожного endpoint.