跳转到主要内容

​
应用中的 AI API

Kazzle 应用应使用 Kazzle 的 AI API 进行聊天、图像、语音、转录和视频处理。除非用户明确要求直接向其他提供商付费，否则不要要求用户提供 OpenAI、Anthropic 或其他提供商的密钥。

​
使用什么

所有应用 AI 调用都通过 https://api.kazzle.app 加上 kzl_ API 密钥进行： 
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 密钥

  1. 为应用创建一个作用域受限的 Kazzle API 密钥。
  2. 将其存储在名为 KAZZLE_API_KEY 的密钥集合 + 环境中（密钥名称成为环境变量键）。
  3. 将流程组件指向该集合 + 环境。
  4. 除非端点通过你自己的后端有意公开，否则保持调用在服务器端。
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_* 变量中。