KIE API 入门指南（重要）

欢迎使用 KIE。本指南将引导您了解将 KIE API 集成到产品中所需的基本信息，包括模型、定价、身份验证、请求流程、限制和支持。

我们致力于透明、实用和开发者友好。请在投入生产环境之前仔细阅读本指南。

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 请求必须包含正确的请求头：

如果缺少或错误这些请求头，您可能会收到：

{"code":401,"msg":"You do not have access permissions"}

在调试身份验证问题时，请务必仔细检查您的请求头。

5. 日志和任务详情

您可以在此处检查所有历史任务：

👉 https://kie.ai/logs

对于每个任务，您可以查看：

创建时间

使用的模型

输入参数

任务状态

积分消耗

最终结果或错误详情

如果您怀疑积分使用不正确，此页面是验证的真实来源。

6. 数据保留策略

请注意我们的保留规则：

生成的媒体文件：存储 14 天，然后自动删除

日志记录（文本/元数据）：存储 2 个月，然后自动删除

如果您需要长期访问，请确保及时下载并在您这边存储结果。

7. 异步任务模型

KIE 上的所有生成任务都是异步的。

成功的请求返回：

HTTP 200

一个 task_id

要获取最终结果，您必须：

在请求中提供回调（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 由一个小型初创团队构建。

我们行动迅速

我们非常关心开发者体验

我们不断改进

同时，我们承认：

并非一切都完美

我们无法立即满足每个用例

您的反馈有助于我们改进 — 我们对此深表感谢。

KIE A​​PI 入门指南（重要）

1. 可用模型和 Playground#

2. 定价#

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

4. 必需的请求头#

5. 日志和任务详情#

6. 数据保留策略#

7. 异步任务模型#

8. 速率限制和并发#

9. 开发者支持#

10. 稳定性预期#

11. 关于团队#