跳轉到主要內容

​
應用程式中的 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_* 變數中。