开始使用 KIE API
欢迎使用 KIE。本指南将带你了解集成 KIE API 所需的基本信息，包括模型、定价、认证方式、请求流程、使用限制和支持等内容。 我们致力于透明、实用和开发者友好。请在部署前仔细阅读本指南。
1. 支持的模型与 Playground
你可以在我们的市场页面找到最新支持的模型：
👉 https://kie.ai/market我们会持续更新并上线新的稳定模型。
每个模型页面都链接到其对应的 Playground，你可以在我们的界面中直接测试和实验，无需编写代码。
Playground 是理解模型行为、参数及输出格式的最佳场所。
2. 价格说明
完整的最新定价列表请见：
👉 https://kie.ai/pricing我们的价格通常比官方服务低 30%–50%。
对于部分模型，折扣甚至可达 80%。
由于上游服务商可能调整成本，价格可能会变动，请始终以定价页面为准。
3. 创建并管理你的 API 密钥
在此处创建和管理您的 API 密钥：
👉 https://kie.ai/api-key重要安全提示：
请勿在代码中暴露您的 API 密钥（如浏览器、移动应用或公共仓库）。
请将您的 API 密钥视为机密信息。为帮助您保护使用安全，我们提供以下功能：
- 每个密钥的调用频率限制（每小时、每日及总使用量上限）
- IP 白名单支持，仅允许已授权的服务器 IP 访问 API
这些功能有助于防止意外超额使用和未授权请求。
4. 必需的请求头（Request Headers）
每个 API 请求都必须包含正确的请求头信息：Authorization: Bearer
Content-Type: application/json
{"code":401,"msg":"您没有访问权限"}调试认证问题时，请务必仔细检查请求头设置。
5. 日志与任务详情
您可以在此查看所有历史任务记录：
👉 https://kie.ai/logs每个任务可查看的信息包括：
- 创建时间
- 使用的模型
- 输入参数
- 任务状态
- 消耗积分
- 最终结果或错误详情如果您怀疑信用消耗异常，此页面是验证信息的唯一来源。
6. 数据保留政策
请注意我们的数据保留规则：
- 生成的媒体文件：保存 14 天后自动删除
- 日志记录（文本/元数据）：保存 2 个月后自动删除如需长期保存，请及时下载并本地备份相关结果。
7. 异步任务模型 异步任务模型意味着任务会在后台处理，您无需等待即可继续操作。
KIE 平台上的所有生成任务都是异步执行的。成功请求将返回：
HTTP 200 状态码
一个 task_id200 响应仅表示任务已创建成功，不代表任务已完成。如需获取最终结果，请执行以下操作之一：
在请求中提供回调（webhook）URL，或
使用 task_id 调用“查询记录信息”API 来主动轮询
8. 请求频率限制与并发数
默认情况下，我们应用以下限制：
每10秒最多20个新请求
通常可支持100多个并发任务
每个账户单独生效如果超出限制：
请求将返回HTTP 429状态码并被拒绝
被拒绝的请求不会进入处理队列对大多数用户而言，该限制已足够使用。如果您持续遇到429错误，可联系客服申请提高限额——审批将谨慎处理。
9. 开发者支持
推荐的支持渠道可在仪表盘的左下角菜单中找到：
在 Discord 上获取帮助
在 Telegram 上获取帮助您将获得：
私密的一对一支持频道
您的数据和对话内容将保持保密
更快更专业的技术支持响应支持时间：UTC 时间 21:00 至 UTC 时间 17:00（次日）
您也可以发送邮件至 [email protected]，但此方式并非首选或最快途径。
10. 稳定性预期
我们提供顶级、极具竞争力的API接口，定价极具竞争力。但请知悉：
我们并非十全十美
整体稳定性可能略低于官方提供商
这是我们有意做出的权衡在实际使用中，KIE API接口稳定性足以支撑生产环境和长期业务发展，但我们希望提前说明实际情况。
11. 关于我们的团队
KIE由一支小型创业团队打造。
我们响应迅速
我们高度重视开发者体验
我们持续优化同时我们也承认：
并非所有功能都完美无缺
无法立刻满足所有使用场景您的反馈是我们不断进步的动力——我们真诚感谢您的每一条反馈。