Saltar al contenido principal

​
AI API en apps

Las apps de Kazzle deben usar la AI API de Kazzle para chat, imágenes, voz, transcripción y vídeo. No pidas a los usuarios claves de OpenAI, Anthropic u otros proveedores a menos que específicamente quieran facturar a esos proveedores directamente.

​
Qué usar

Todas las llamadas de IA de la app van a través de https://api.kazzle.app más una clave 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 es una credencial de app que creas con la herramienta api_key, almacenas en el vault e integras en el componente process de la app.

​
Endpoints comunes

TareaEndpoint
Chat o generación de textoPOST /ai/chat/completions
ImágenesPOST /ai/images/generations
Texto a vozPOST /ai/audio/speech
Voz a textoPOST /ai/audio/transcriptions
Generación de vídeoPOST /ai/video/generations
Catálogo de modelosGET /ai/models
Lee /ai/models primero cuando la app necesite elegir un modelo dinámicamente.

​
Integrar la clave API

  1. Crea una clave API de Kazzle con alcance para la app.
  2. Almacénala en una colección de secretos + entorno con el nombre KAZZLE_API_KEY (el nombre del secreto se convierte en la clave de variable de entorno).
  3. Apunta el componente process a esa colección + entorno.
  4. Mantén las llamadas del lado del servidor a menos que el endpoint sea intencionalmente público a través de tu propio backend.
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
El proceso server verá process.env.KAZZLE_API_KEY resuelto desde el vault en tiempo de ejecución. No hay campo env.vars — los secretos solo llegan a los componentes de la app a través de la colección + entorno a la que apuntan. Nunca pongas una clave API privada en código frontend o en una variable VITE_*.