跳轉到主要內容
Kazzle AI API 為您提供一個經過身份驗證的端點來呼叫我們支援的任何模型。您只需支付一次信用額度，針對您的空間 — 無需為 OpenAI、Anthropic、Cloudflare Workers AI 或我們路由到的任何其他服務建立單獨帳戶。 所有端點都位於 https://api.kazzle.app 上的 /ai/* 下，並在 Authorization 標頭中接受 kzl_ API 金鑰。請參閱 API 金鑰 了解如何建立金鑰。 生成的 Kazzle 應用程式也應使用此 API。為應用程式建立 Kazzle API 金鑰，將其儲存在保管庫中，在流程元件上將其設定為 KAZZLE_API_KEY，並從該伺服器端程式碼呼叫 https://api.kazzle.app/ai/*。除非使用者明確想要使用自己的提供者帳戶，否則不要要求使用者提供提供者金鑰。

​
功能

端點模式標準化輸入標準化輸出
POST /ai/chat/completions聊天（文字、串流）OpenAI 相容 messages[]OpenAI 相容 choices[] 或 SSE 串流
POST /ai/responses回應 APIOpenAI 回應相容OpenAI 回應相容
POST /ai/images/generations圖像{ model, prompt, size?, output_format? }{ images: [{ url? | b64?, mimeType }] }
POST /ai/audio/speech文字轉語音{ model, text, voice?, format? }audio/* 位元組串流
POST /ai/audio/transcriptions語音轉文字multipart/form-data 含 file + model{ text }
POST /ai/video/generations影片（非同步）{ model, prompt, ... }{ id, status, pollUrl }
GET /ai/responses/{id}非同步輪詢回應 id提供者格式結果
POST /ai/gateway原始傳遞任何 Workers AI / 提供者原生承載原始上游回應
GET /ai/models目錄—{ models: [{ id, modality, pricing, ... }] }
GET /ai/models 是哪些模型 id 適用於哪些端點的真實來源。如果您針對 API 進行構建，請先閱讀它。

​
呼叫如何運作

每個可計費呼叫都會經過五個階段。您看不到大多數階段 — 它們在伺服器端進行追蹤，以便我們可以退款失敗的呼叫並報告確切的使用情況。
階段發生的情況
open我們已建立與您的請求相關的計費事件，但尚未呼叫上游。
recorded上游提供者已回應。我們有來自 Cloudflare AI Gateway 的日誌 id。成本尚未確定。
pricedCloudflare 報告了最終成本。我們應用了標記並寫入了信用額度扣費。終端。
failed上游呼叫失敗，或我們在 20 次重試後無法獲得成本。客戶不會被扣費。終端。
synced定價事件已傳遞到我們的計量系統。
每個成功的回應都包含 x-kazzle-ai-billing-event-id: airesp_... — 如果您想稍後將請求與使用情況匯出相關聯，請保留它。

​
計費與標記

我們收費 cloudflare_cost_usd × (1 + markup)。標記發佈在 設定 → 計費 → 定價。Cloudflare 定價為 $0 的呼叫（免費 Workers AI 層級、促銷）以零成本達到 priced 階段，永遠不會被計費。 預留：您需要至少 $0.50 等值的信用額度才能進行呼叫。我們將其保留在您的餘額中，直到呼叫完成，然後結算實際成本。

​
錯誤

狀態含義
401遺失或無效的 kzl_ API 金鑰。
402預留信用額度不足。在 設定 → 計費 中充值。
4xx 來自上游按原樣轉發。正文包含提供者的錯誤。客戶不會被計費。
5xx 來自上游按原樣轉發。客戶不會被計費。

​
範例 — 圖像生成

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" }
  ]
}

​
範例 — 文字轉語音

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

​
另請參閱

  • API 參考 — 每個端點的完整請求/回應架構
  • API 金鑰 — 建立和使用 kzl_ 金鑰
  • 計費 — 信用額度、方案和我們應用的標記