跳转到主要内容

1. 可用模型和 Playground

您可以在我们的 Market 页面找到最新支持的模型 👉 https://kie.ai/market
  • 我们会在模型稳定后持续更新并上线新模型。
  • 每个模型页面都链接到其 Playground,您可以在调用 API 之前在我们的 UI 中直接测试和实验。
  • Playground 是了解模型行为、参数和输出格式的最佳场所。

2. 定价

完整且最新的定价列表可在此处查看: 👉 https://kie.ai/pricing
  • 我们的价格通常比官方 API 低 30%–50%
  • 对于某些模型,折扣可达高达 80%
  • 随着上游提供商调整成本,定价可能会发生变化,因此请始终参考定价页面获取最新数字。

3. 创建和保护您的 API 密钥

在此处创建和管理您的 API 密钥: 👉 https://kie.ai/api-key 重要的安全提示:
  • 切勿在前端代码中暴露您的 API 密钥(浏览器、移动应用、公共仓库)。
  • 将您的 API 密钥视为机密。
为了帮助保护您的使用,我们提供:
  • 每个密钥的速率限制(每小时、每日和总使用量上限)
  • IP 白名单支持,仅允许已批准的服务器 IP 访问 API
这些功能有助于防止意外过度使用和未经授权的请求。

4. 必需的请求头

每个 API 请求必须包含正确的请求头:
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
如果缺少或错误这些请求头,您可能会收到:
{"code":401,"msg":"You do not have access permissions"}
在调试身份验证问题时,请务必仔细检查您的请求头。

5. 日志和任务详情

您可以在此处检查所有历史任务: 👉 https://kie.ai/logs 对于每个任务,您可以查看:
  • 创建时间
  • 使用的模型
  • 输入参数
  • 任务状态
  • 积分消耗
  • 最终结果或错误详情
如果您怀疑积分使用不正确,此页面是验证的真实来源。

6. 数据保留策略

请注意我们的保留规则:
  • 生成的媒体文件:存储 14 天,然后自动删除
  • 日志记录(文本/元数据):存储 2 个月,然后自动删除
如果您需要长期访问,请确保及时下载并在您这边存储结果。

7. 异步任务模型

KIE 上的所有生成任务都是异步的。 成功的请求返回:
  • HTTP 200
  • 一个 task_id
200 响应仅表示任务已创建,而非已完成。
要获取最终结果,您必须:
  • 在请求中提供回调(webhook)URL,或
  • 使用 task_id 主动轮询”查询记录信息” API

8. 速率限制和并发

默认情况下,我们应用以下限制:
  • 每 10 秒最多 20 个新的生成请求
  • 这通常允许 100+ 个并发运行的任务
  • 限制按账户应用
如果您超过限制:
  • 请求将被拒绝,返回 HTTP 429
  • 被拒绝的请求不会进入队列
对于大多数用户来说,这已经足够了。 如果您持续遇到 429 错误,可以联系支持以请求更高的限制 — 审批会谨慎处理。

9. 开发者支持

推荐的支持渠道可直接从仪表板(左下角菜单)获取:
  • 在 Discord 上获取帮助
  • 在 Telegram 上获取帮助
您将获得:
  • 私密的一对一渠道
  • 您的数据和对话保持机密
  • 更快、更专业的技术响应
支持时间: UTC 21:00 – UTC 17:00(次日) 您也可以发送邮件至 support@kie.ai,但这不是首选或最快的选项。

10. 稳定性预期

我们以非常具有竞争力的价格提供顶级、高度竞争的 API 访问。 也就是说:
  • 我们并不完美
  • 我们的整体稳定性可能略低于官方提供商
  • 这是一个有意识的权衡
在实践中,KIE 足够稳定,可以支持生产工作负载和长期业务增长,但我们相信提前设定现实的预期。

11. 关于团队

KIE 由一个小型初创团队构建。
  • 我们行动迅速
  • 我们非常关心开发者体验
  • 我们不断改进
同时,我们承认:
  • 并非一切都完美
  • 我们无法立即满足每个用例
您的反馈有助于我们改进 — 我们对此深表感谢。