跳转到主要内容
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_ 密钥
  • 计费 — 积分、计划和我们应用的加价