Zum Hauptinhalt springen

​
AI API in Apps

Kazzle-Apps sollten Kazzles AI API für Chat, Bilder, Sprache, Transkription und Video nutzen. Fragen Sie Benutzer nicht nach OpenAI-, Anthropic- oder anderen Provider-Schlüsseln, es sei denn, sie möchten diese Provider direkt abrechnen.

​
Was zu verwenden ist

Alle App-KI-Aufrufe laufen über https://api.kazzle.app plus einen kzl_ API-Schlüssel: 
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 ist ein App-Credential, das Sie mit dem api_key-Tool erstellen, im Vault speichern und in die Process-Komponente der App verdrahten.

​
Häufige Endpunkte

AufgabeEndpunkt
Chat oder TextgenerierungPOST /ai/chat/completions
BilderPOST /ai/images/generations
Text zu SprachePOST /ai/audio/speech
Sprache zu TextPOST /ai/audio/transcriptions
VideogenerierungPOST /ai/video/generations
ModellkatalogGET /ai/models
Lesen Sie /ai/models zuerst, wenn die App ein Modell dynamisch auswählen muss.

​
API-Schlüssel verdrahten

  1. Erstellen Sie einen scoped Kazzle API-Schlüssel für die App.
  2. Speichern Sie ihn in einer Secret-Collection + Umgebung mit dem Namen KAZZLE_API_KEY (der Secret-Name wird zum Env-Var-Schlüssel).
  3. Verweisen Sie die Process-Komponente auf diese Collection + Umgebung.
  4. Halten Sie Aufrufe serverseitig, es sei denn, der Endpunkt ist absichtlich öffentlich über Ihr eigenes Backend.
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Der Server-Process sieht process.env.KAZZLE_API_KEY zur Laufzeit aus dem Vault aufgelöst. Es gibt kein env.vars-Feld — Secrets erreichen App-Komponenten nur über die Collection + Umgebung, auf die sie verweisen. Setzen Sie niemals einen privaten API-Schlüssel in Frontend-Code oder eine VITE_*-Variable.