Naar hoofdinhoud gaan

​
AI API in apps

Kazzle-apps moeten Kazzle’s AI API gebruiken voor chat, afbeeldingen, spraak, transcriptie en video. Vraag gebruikers niet om OpenAI-, Anthropic- of andere provider-sleutels tenzij zij specifiek die providers rechtstreeks willen factureren.

​
Wat te gebruiken

Alle app AI-aanroepen gaan via https://api.kazzle.app plus een kzl_ API-sleutel: 
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 is een app-referentie die je maakt met de api_key-tool, opslaat in de vault en aansluit op de process-component van de app.

​
Veelgebruikte eindpunten

TaakEindpunt
Chat of tekstgeneratiePOST /ai/chat/completions
AfbeeldingenPOST /ai/images/generations
Tekst naar spraakPOST /ai/audio/speech
Spraak naar tekstPOST /ai/audio/transcriptions
VideogeneratiePOST /ai/video/generations
ModelcatalogusGET /ai/models
Lees /ai/models eerst wanneer de app dynamisch een model moet kiezen.

​
De API-sleutel aansluiten

  1. Maak een scoped Kazzle API-sleutel voor de app.
  2. Sla deze op in een geheime collectie + omgeving met de naam KAZZLE_API_KEY (de geheime naam wordt de omgevingsvariabelesleutel).
  3. Wijs de process-component naar die collectie + omgeving.
  4. Houd aanroepen server-side tenzij het eindpunt opzettelijk openbaar is via je eigen backend.
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Het server-process ziet process.env.KAZZLE_API_KEY opgelost vanuit de vault bij runtime. Er is geen env.vars-veld — geheimen bereiken app-componenten alleen via de collectie + omgeving waarop zij wijzen. Plaats nooit een privé-API-sleutel in frontend-code of een VITE_*-variabele.