Chuyển đến nội dung chính
Kazzle AI API cung cấp một endpoint được xác thực để gọi bất kỳ mô hình nào chúng tôi hỗ trợ. Bạn thanh toán một lần, bằng tín chỉ, theo không gian của bạn — không cần tài khoản riêng cho OpenAI, Anthropic, Cloudflare Workers AI, hoặc bất kỳ ai khác mà chúng tôi định tuyến đến. Tất cả các endpoint nằm dưới /ai/* trên https://api.kazzle.app và chấp nhận khóa API kzl_ trong header Authorization. Xem API keys để biết cách tạo một khóa. Các ứng dụng Kazzle được tạo ra cũng nên sử dụng API này. Tạo khóa API Kazzle cho ứng dụng, lưu trữ nó trong vault, kết nối nó dưới dạng KAZZLE_API_KEY trên thành phần quy trình, và gọi https://api.kazzle.app/ai/* từ mã phía máy chủ đó. Không yêu cầu người dùng cung cấp khóa nhà cung cấp trừ khi họ rõ ràng muốn sử dụng tài khoản nhà cung cấp của riêng họ.

​
Khả năng

EndpointPhương thứcĐầu vào chuẩn hóaĐầu ra chuẩn hóa
POST /ai/chat/completionsChat (văn bản, streaming)messages[] tương thích OpenAIchoices[] tương thích OpenAI hoặc luồng SSE
POST /ai/responsesResponses APITương thích OpenAI ResponsesTương thích OpenAI Responses
POST /ai/images/generationsHình ảnh{ model, prompt, size?, output_format? }{ images: [{ url? | b64?, mimeType }] }
POST /ai/audio/speechText-to-speech{ model, text, voice?, format? }luồng byte audio/*
POST /ai/audio/transcriptionsSpeech-to-textmultipart/form-data với file + model{ text }
POST /ai/video/generationsVideo (không đồng bộ){ model, prompt, ... }{ id, status, pollUrl }
GET /ai/responses/{id}Bỏ phiếu không đồng bộid phản hồikết quả hình dạng nhà cung cấp
POST /ai/gatewayChuyển tiếp thôBất kỳ Workers AI / tải trọng gốc nhà cung cấpPhản hồi thượng nguồn thô
GET /ai/modelsDanh mục—{ models: [{ id, modality, pricing, ... }] }
GET /ai/models là nguồn sự thật cho biết id mô hình nào hoạt động trên endpoint nào. Hãy đọc nó trước nếu bạn đang xây dựng dựa trên API.

​
Cách một cuộc gọi hoạt động

Mỗi cuộc gọi có thể tính phí đi qua năm giai đoạn. Bạn không thấy hầu hết những giai đoạn này — chúng được theo dõi phía máy chủ để chúng tôi có thể hoàn lại các cuộc gọi không thành công và báo cáo mức sử dụng chính xác.
Giai đoạnĐiều gì đã xảy ra
openChúng tôi đã tạo một sự kiện thanh toán được liên kết với yêu cầu của bạn, nhưng chưa gọi thượng nguồn.
recordedNhà cung cấp thượng nguồn đã trả lời. Chúng tôi có id nhật ký từ Cloudflare AI Gateway. Chi phí chưa được biết.
pricedCloudflare đã báo cáo chi phí cuối cùng. Chúng tôi áp dụng đánh dấu của chúng tôi và ghi lại khoản phí tín chỉ. Cuối cùng.
failedCuộc gọi thượng nguồn không thành công, hoặc chúng tôi không thể lấy chi phí sau 20 lần thử lại. Khách hàng không bị tính phí. Cuối cùng.
syncedSự kiện được định giá đã được gửi đến hệ thống đo lường của chúng tôi.
Mỗi phản hồi thành công bao gồm x-kazzle-ai-billing-event-id: airesp_... — giữ nó nếu bạn muốn tương quan yêu cầu với các bản xuất sử dụng sau này.

​
Thanh toán & đánh dấu

Chúng tôi tính phí cloudflare_cost_usd × (1 + markup). Đánh dấu được công bố trong Settings → Billing → Pricing. Các cuộc gọi mà Cloudflare định giá ở $0 (tầng Workers AI miễn phí, khuyến mãi) đạt giai đoạn priced với chi phí bằng không và không bao giờ bị tính phí. Dự trữ: bạn cần ít nhất $0.50 tương đương tín chỉ để thực hiện cuộc gọi. Chúng tôi giữ điều này so với số dư của bạn cho đến khi cuộc gọi kết thúc, sau đó thanh toán chi phí thực tế.

​
Lỗi

Trạng tháiÝ nghĩa
401Khóa API kzl_ bị thiếu hoặc không hợp lệ.
402Tín chỉ không đủ cho dự trữ. Nạp tiền trong Settings → Billing.
4xx từ thượng nguồnChuyển tiếp nguyên trạng. Phần thân chứa lỗi của nhà cung cấp. Khách hàng không bị tính phí.
5xx từ thượng nguồnChuyển tiếp nguyên trạng. Khách hàng không bị tính phí.

​
Ví dụ — tạo hình ảnh

curl https://api.kazzle.app/ai/images/generations \
  -H "Authorization: Bearer kzl_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "a single red dot on white",
    "size": "1024x1024"
  }'

{
  "images": [
    { "url": "https://...", "mimeType": "image/png" }
  ]
}

​
Ví dụ — chuyển văn bản thành giọng nói

curl https://api.kazzle.app/ai/audio/speech \
  -H "Authorization: Bearer kzl_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/tts-1","text":"hello world","voice":"alloy","format":"mp3"}' \
  --output speech.mp3

​
Xem thêm