Passer au contenu principal

​
API IA dans les apps

Les apps Kazzle doivent utiliser l’API IA de Kazzle pour le chat, les images, la parole, la transcription et la vidéo. Ne demandez pas aux utilisateurs leurs clés OpenAI, Anthropic ou d’autres fournisseurs sauf s’ils veulent spécifiquement facturer ces fournisseurs directement.

​
Quoi utiliser

Tous les appels IA des apps passent par https://api.kazzle.app plus une clé API kzl_ : 
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 est une credential d’app que vous créez avec l’outil api_key, stockez dans le vault, et connectez au composant process de l’app.

​
Endpoints courants

TâcheEndpoint
Chat ou génération de textePOST /ai/chat/completions
ImagesPOST /ai/images/generations
Synthèse vocalePOST /ai/audio/speech
Reconnaissance vocalePOST /ai/audio/transcriptions
Génération vidéoPOST /ai/video/generations
Catalogue de modèlesGET /ai/models
Lisez /ai/models en premier quand l’app doit choisir un modèle dynamiquement.

​
Connecter la clé API

  1. Créez une clé API Kazzle scoped pour l’app.
  2. Stockez-la dans une collection secrète + environnement avec le nom KAZZLE_API_KEY (le nom du secret devient la clé de variable d’env).
  3. Pointez le composant process vers cette collection + environnement.
  4. Gardez les appels côté serveur sauf si l’endpoint est intentionnellement public via votre propre backend.
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Le process serveur verra process.env.KAZZLE_API_KEY résolu depuis le vault à l’exécution. Il n’y a pas de champ env.vars — les secrets ne rejoignent les composants d’app que via la collection + environnement vers lesquels ils pointent. Ne mettez jamais une clé API privée dans le code frontend ou une variable VITE_*.