Saltar para o conteúdo principal

​
AI API em apps

Apps Kazzle devem usar a AI API de Kazzle para chat, imagens, fala, transcrição e vídeo. Não peça aos usuários chaves OpenAI, Anthropic ou de outros provedores a menos que queiram faturar esses provedores diretamente.

​
O que usar

Todas as chamadas de IA do app passam por https://api.kazzle.app mais uma chave de 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 é uma credencial do app que você cria com a ferramenta api_key, armazena no vault e conecta ao componente process do app.

​
Endpoints comuns

TarefaEndpoint
Chat ou geração de textoPOST /ai/chat/completions
ImagensPOST /ai/images/generations
Texto para falaPOST /ai/audio/speech
Fala para textoPOST /ai/audio/transcriptions
Geração de vídeoPOST /ai/video/generations
Catálogo de modelosGET /ai/models
Leia /ai/models primeiro quando o app precisa escolher um modelo dinamicamente.

​
Conectando a chave de API

  1. Crie uma chave de API Kazzle com escopo para o app.
  2. Armazene em uma coleção de segredos + ambiente com o nome KAZZLE_API_KEY (o nome do segredo se torna a chave da variável de ambiente).
  3. Aponte o componente process para essa coleção + ambiente.
  4. Mantenha as chamadas no servidor a menos que o endpoint seja intencionalmente público através do seu próprio backend.
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
O processo do servidor verá process.env.KAZZLE_API_KEY resolvido do vault em tempo de execução. Não há campo env.vars — segredos só chegam aos componentes do app através da coleção + ambiente que apontam para. Nunca coloque uma chave de API privada em código frontend ou em uma variável VITE_*.