Vai al contenuto principale

​
AI API nelle app

Le app Kazzle devono usare l’AI API di Kazzle per chat, immagini, sintesi vocale, trascrizione e video. Non chiedere agli utenti chiavi OpenAI, Anthropic o di altri provider a meno che non vogliano fatturare direttamente a quei provider.

​
Cosa usare

Tutte le chiamate AI delle app passano per https://api.kazzle.app più una chiave 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 è una credenziale dell’app che crei con lo strumento api_key, memorizzi nel vault e colleghi al componente process dell’app.

​
Endpoint comuni

OperazioneEndpoint
Chat o generazione testoPOST /ai/chat/completions
ImmaginiPOST /ai/images/generations
Sintesi vocalePOST /ai/audio/speech
Trascrizione vocalePOST /ai/audio/transcriptions
Generazione videoPOST /ai/video/generations
Catalogo modelliGET /ai/models
Leggi /ai/models per primo quando l’app deve scegliere un modello dinamicamente.

​
Collegare la chiave API

  1. Crea una chiave API Kazzle con scope per l’app.
  2. Memorizzala in una raccolta segreta + ambiente con il nome KAZZLE_API_KEY (il nome del segreto diventa la chiave della variabile d’ambiente).
  3. Punta il componente process a quella raccolta + ambiente.
  4. Mantieni le chiamate lato server a meno che l’endpoint non sia intenzionalmente pubblico attraverso il tuo backend.
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Il processo server vedrà process.env.KAZZLE_API_KEY risolto dal vault a runtime. Non esiste un campo env.vars — i segreti raggiungono i componenti dell’app solo attraverso la raccolta + ambiente a cui puntano. Non mettere mai una chiave API privata nel codice frontend o in una variabile VITE_*.