应用中的 AI

应用通过 Kazzle AI API 获得 AI 功能（聊天、图像、语音、转录、视频）— 一个端点，按积分计费，从空间扣费。除非用户明确要求直接向 OpenAI/Anthropic 等供应商计费，否则不要要求用户提供这些供应商的密钥。端点、计费和示例已在 AI API 参考中完整记录。本页仅介绍如何将其集成到应用中。

配置 API 密钥

使用 api_key 工具为应用创建一个作用域受限的 Kazzle API 密钥。
将其存储在密钥集合 + 环境中，命名为 KAZZLE_API_KEY（密钥名称会成为环境变量）。
将流程组件指向该集合 + 环境。
仅从服务器端代码调用 https://api.kazzle.app/ai/*。

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

运行时流程会看到 process.env.KAZZLE_API_KEY，从保险库解析。没有 env.vars 字段 — 密钥仅通过组件指向的集合 + 环境传递给组件。

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_* 变量中。参见密钥了解保险库配置，以及 AI API 参考查看所有端点。