メインコンテンツへスキップ

​
アプリ内の 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 ツールで作成し、Vault に保存し、アプリのプロセスコンポーネントに接続します。

​
一般的なエンドポイント

処理エンドポイント
チャットまたはテキスト生成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'
      }
    }
  ]
});
サーバープロセスは、実行時に Vault から解決された process.env.KAZZLE_API_KEY を参照します。env.vars フィールドはありません。シークレットはコレクション + 環境を通じてのみアプリコンポーネントに到達します。 プライベート API キーをフロントエンドコードまたは VITE_* 変数に入れないでください。