欢迎使用 KIE。本指南将引导您了解将 KIE API 集成到产品中所需的基本信息,包括模型、定价、身份验证、请求流程、限制和支持。
我们致力于透明、实用和开发者友好。请在投入生产环境之前仔细阅读本指南。1. 可用模型和 Playground#
您可以在我们的 Market 页面找到最 新支持的模型:每个模型页面都链接到其 Playground,您可以在调用 API 之前在我们的 UI 中直接测试和实验。
Playground 是了解模型行为、参数和输出格式的最佳场所。
2. 定价#
KIE 为所有模型提供统一的接口与统一的积分计费。
3. 创建和保护您的 API 密钥#
切勿在前端代码中暴露您的 API 密钥(浏览器、移动应用、公共仓库)。
IP 白名单支持,仅允许已批准的服务器 IP 访问 API
4. 必需的请求头#
JSON 请求体需带 Content-Type: application/json(文件流上传使用 multipart/form-data)。{"code":401,"msg":"You do not have access permissions"}
/api/v1/* 与上传接口出错时 HTTP 状态仍为 200,错误码在响应体 code 中(如 {"code":429,…}),请始终判断 code。
5. 日志和任务详情#
如果您怀疑积分使用不正确,此页面是验证的真实来源。
6. 数据保留策略#
日志记录(文本/元数据):存储 2 个月,然后自动删除
如果您需要长期访问,请确保及时下载并在您这边存储结果。
7. 异步任务模型#
图像、视频、音乐生成任务为异步:先创建任务,再通过获取任务详情查询或接收回调。聊天模型为同步接口,结果直接在响应中返回。成功时返回 {"code": 200, "data": {"taskId": "…"}}。200 响应仅表示任务已创建成功,不代表任务已完成。
用 data.taskId 轮询 GET /api/v1/jobs/recordInfo?taskId=…(见获取任务详情)
8. 速率限制和并发#
对于大多数用户来说,这已经足够了。
如果您持续遇到 429 错误,可以联系支持以请求更高的限制 — 审批会谨慎处理。
9. 开发者支持#
支持时间:
UTC 21:00 – UTC 17:00(次日)
10. 稳定性预期#
我们以非常具有竞争力的价格提供顶级、高度竞争的 API 访问。在实践中,KIE 足够稳定,可以支持生产工作负载和长期业务增长,但我们相信提前设定现实的预期。
11. 关于团队#