AI API в додатках

Додатки Kazzle повинні використовувати AI API Kazzle для чату, зображень, мовлення, транскрипції та відео. Не просіть у користувачів ключі OpenAI, Anthropic або інших постачальників, якщо вони спеціально не хочуть платити цим постачальникам напряму.

Що використовувати

Усі виклики AI в додатках проходять через https://api.kazzle.app плюс ключ API kzl_:

const apiUrl = 'https://api.kazzle.app';
const apiKey = process.env.KAZZLE_API_KEY;

if (!apiKey) {
  throw new Error('KAZZLE_API_KEY is required');
}

const response = await fetch(`${apiUrl}/ai/audio/transcriptions`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${apiKey}` },
  body: formData,
});

KAZZLE_API_KEY — це облікові дані додатка, які ви створюєте за допомогою інструменту api_key, зберігаєте в сховищі та підключаєте до компонента процесу додатка.

Поширені кінцеві точки

Завдання	Кінцева точка
Чат або генерація тексту	`POST /ai/chat/completions`
Зображення	`POST /ai/images/generations`
Синтез мовлення	`POST /ai/audio/speech`
Розпізнавання мовлення	`POST /ai/audio/transcriptions`
Генерація відео	`POST /ai/video/generations`
Каталог моделей	`GET /ai/models`

Спочатку прочитайте /ai/models, коли додатку потрібно динамічно вибрати модель.

Підключення ключа API

Створіть обмежений ключ API Kazzle для додатка.
Збережіть його в колекції секретів + середовищі з назвою KAZZLE_API_KEY (назва секрету стає ключем змінної середовища).
Вкажіть компонент процесу на цю колекцію + середовище.
Тримайте виклики на стороні сервера, якщо кінцева точка не є навмисно публічною через ваш власний бекенд.

export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});

Процес сервера побачить process.env.KAZZLE_API_KEY, розв’язаний зі сховища під час виконання. Немає поля env.vars — секрети досягають компонентів додатка лише через колекцію + середовище, на які вони вказують. Ніколи не розміщуйте приватний ключ API у коді фронтенду або змінній VITE_*.

​AI API в додатках

​Що використовувати

​Поширені кінцеві точки

​Підключення ключа API

AI API в додатках

Що використовувати

Поширені кінцеві точки

Підключення ключа API