Przejdź do głównej treści

​
AI API w aplikacjach

Aplikacje Kazzle powinny używać AI API Kazzle do czatu, obrazów, mowy, transkrypcji i wideo. Nie pytaj użytkowników o klucze OpenAI, Anthropic lub innych dostawców, chyba że chcą bezpośrednio rozliczać tych dostawców.

​
Co używać

Wszystkie wywołania AI aplikacji przechodzą przez https://api.kazzle.app plus klucz 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 to poświadczenie aplikacji, które tworzysz za pomocą narzędzia api_key, przechowujesz w Vault i podłączasz do komponentu procesu aplikacji.

​
Popularne punkty końcowe

ZadaniePunkt końcowy
Chat lub generowanie tekstuPOST /ai/chat/completions
ObrazyPOST /ai/images/generations
Zamiana tekstu na mowęPOST /ai/audio/speech
Zamiana mowy na tekstPOST /ai/audio/transcriptions
Generowanie wideoPOST /ai/video/generations
Katalog modeliGET /ai/models
Przeczytaj /ai/models najpierw, gdy aplikacja musi dynamicznie wybrać model.

​
Podłączanie klucza API

  1. Utwórz ograniczony klucz API Kazzle dla aplikacji.
  2. Przechowuj go w kolekcji sekretów + środowisku o nazwie KAZZLE_API_KEY (nazwa sekretu staje się kluczem zmiennej środowiskowej).
  3. Wskaż komponent procesu na tę kolekcję + środowisko.
  4. Utrzymuj wywołania po stronie serwera, chyba że punkt końcowy jest celowo publiczny przez Twój własny backend.
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Proces serwera będzie widział process.env.KAZZLE_API_KEY rozwiązany z Vault w czasie wykonywania. Nie ma pola env.vars — sekrety docierają do komponentów aplikacji tylko przez kolekcję + środowisko, na które wskazują. Nigdy nie umieszczaj prywatnego klucza API w kodzie frontend lub zmiennej VITE_*.