Chuyển đến nội dung chính

AI API trong ứng dụng

Các ứng dụng Kazzle nên sử dụng AI API của Kazzle cho chat, hình ảnh, giọng nói, chuyển đổi giọng nói thành văn bản và video. Không yêu cầu người dùng cung cấp khóa OpenAI, Anthropic hoặc các nhà cung cấp khác trừ khi họ cụ thể muốn thanh toán trực tiếp cho các nhà cung cấp đó.

Những gì cần sử dụng

Tất cả các lệnh gọi AI của ứng dụng đi qua https://api.kazzle.app cộng với khóa 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 là thông tin xác thực ứng dụng mà bạn tạo bằng công cụ api_key, lưu trữ trong vault và kết nối vào thành phần process của ứng dụng.

Các endpoint phổ biến

Công việcEndpoint
Chat hoặc tạo văn bảnPOST /ai/chat/completions
Hình ảnhPOST /ai/images/generations
Chuyển đổi văn bản thành giọng nóiPOST /ai/audio/speech
Chuyển đổi giọng nói thành văn bảnPOST /ai/audio/transcriptions
Tạo videoPOST /ai/video/generations
Danh mục mô hìnhGET /ai/models
Đọc /ai/models trước khi ứng dụng cần chọn mô hình một cách động.

Kết nối khóa API

  1. Tạo khóa API Kazzle có phạm vi cho ứng dụng.
  2. Lưu trữ nó trong bộ sưu tập bí mật + môi trường với tên KAZZLE_API_KEY (tên bí mật trở thành khóa biến môi trường).
  3. Trỏ thành phần process đến bộ sưu tập + môi trường đó.
  4. Giữ các lệnh gọi ở phía máy chủ trừ khi endpoint được công khai một cách cố ý thông qua backend của riêng bạn.
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Quy trình máy chủ sẽ thấy process.env.KAZZLE_API_KEY được giải quyết từ vault tại thời điểm chạy. Không có trường env.vars — các bí mật chỉ đến các thành phần ứng dụng thông qua bộ sưu tập + môi trường mà chúng trỏ đến. Không bao giờ đặt khóa API riêng tư trong mã frontend hoặc biến VITE_*.