开始使用 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
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（次日） 您也可以发送邮件至 [email protected]，但此方式并非首选或最快途径。
10. 稳定性预期
我们提供顶级、极具竞争力的API接口，定价极具竞争力。 但请知悉： 我们并非十全十美 整体稳定性可能略低于官方提供商 这是我们有意做出的权衡 在实际使用中，KIE API接口稳定性足以支撑生产环境和长期业务发展，但我们希望提前说明实际情况。
11. 关于我们的团队
KIE由一支小型创业团队打造。 我们响应迅速 我们高度重视开发者体验 我们持续优化 同时我们也承认： 并非所有功能都完美无缺 无法立刻满足所有使用场景 您的反馈是我们不断进步的动力——我们真诚感谢您的每一条反馈。