Перейти к основному содержанию

​
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, сохраняете в Vault и подключаете к компоненту process приложения.

​
Основные эндпоинты

ЗадачаЭндпоинт
Чат или генерация текста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-ключа

  1. Создайте ограниченный API-ключ Kazzle для приложения.
  2. Сохраните его в коллекцию секретов + окружение с именем KAZZLE_API_KEY (имя секрета становится ключом переменной окружения).
  3. Укажите компоненту process на эту коллекцию + окружение.
  4. Держите вызовы на серверной стороне, если только эндпоинт не является намеренно открытым через ваш собственный бэкенд.
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Процесс server будет видеть process.env.KAZZLE_API_KEY, разрешённый из Vault во время выполнения. Нет поля env.vars — секреты попадают в компоненты приложения только через коллекцию + окружение, на которые они указывают. Никогда не помещайте приватный API-ключ в код фронтенда или переменную VITE_*.