ModKie API 入门指南

欢迎使用 ModKie。本文档涵盖上线前需要了解的核心内容：可用模型、定价、API Key 安全、异步请求流程、限流、数据保留策略以及开发者支持。

ModKie 是 Kie 兼容的统一 AI API 平台，支持视频、图像、音频和语言模型，并提供开源模型部署与微调能力。建议在生产环境接入前完整阅读本页。

1. 可用模型与 Playground

在模型市场浏览最新支持的模型：

👉 https://modkie.com/market

我们会持续接入稳定可用的新模型。
每个模型都链接到 Playground（/playground/{slug}），可在 UI 中测试参数和输出格式，再复制到 API 调用。
Playground 是理解模型行为、验证 createTask 请求体的最快方式。

完整精选目录见 Market Models。

2. 定价

最新积分单价请查看定价页：

👉 https://modkie.com/pricing

仅在任务成功完成时扣费。
失败任务不扣费。
上游供应商调价时，定价可能变化，请以定价页为准。

3. 创建与保护 API Key

在此创建和管理 API Key：

👉 https://modkie.com/settings/apikeys

安全须知：

切勿在前端代码（浏览器、移动 App、公开仓库）中暴露 API Key。
将 API Key 视为机密凭证。

Key 设置中可选的保护措施：

限流 — 按小时、按天、总量上限
IP 白名单 — 仅允许指定服务器 IP 访问

有助于防止误用和未授权请求。

4. 必需的请求头

每次 API 请求必须包含：

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

头信息缺失或错误时，可能返回：

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

排查鉴权问题时，请先核对请求头。

5. 日志与任务详情

在此查看所有历史 API 任务：

👉 https://modkie.com/logs

每条任务可查看：

创建时间
使用的模型
输入参数
任务状态
积分消耗
最终结果或错误信息

如对积分扣费有疑问，以日志页为准。

6. 数据保留策略

数据类型	保留时长
生成的媒体文件	14 天后自动删除
请求日志（文本/元数据）	2 个月后自动删除

如需长期保存，请及时下载并存储到自有系统。

7. 异步任务模型

ModKie 上所有生成类任务均为异步。

createTask 成功时返回：

HTTP 200
taskId

:::warning 200 OK 仅表示任务已入队，不代表生成已完成。 :::

获取最终结果的方式：

在 createTask 请求体顶层传入 callBackUrl（见 Webhooks），或
使用 taskId 轮询 recordInfo

快速参考：

POST https://modkie.com/api/v1/jobs/createTask
GET  https://modkie.com/api/v1/jobs/recordInfo?taskId={taskId}

8. 限流与并发

平台默认限制：

每个账户 每 10 秒最多 20 个新生成请求
超限返回 HTTP 429，不会进入队列
可在 API Key 设置中配置按小时/按天的额外上限

若持续遇到 429，可联系支持申请更高限额。

9. 开发者支持

推荐渠道：

Discord — 社区与技术答疑
Telegram — 社区动态
邮箱：[email protected]（响应较慢）

10. 稳定性说明

ModKie 通过上游中继以有竞争力的价格提供主流 AI API。

同时请知悉：

我们并非完美
整体稳定性可能略低于直接调用官方 API
这是在成本与统一接入之间的权衡

实践中 ModKie 足以支撑生产负载，但我们希望提前设定合理预期。

11. 关于 ModKie

ModKie 的定位是 「开源模型的 Kie.ai + 模型落地顾问」 — 统一 AI API 平台，并帮助团队部署、微调与集成开源模型。

下一步：

Market Quickstart — 几分钟完成首次 API 调用
API Platform 概览 — 端点与计费说明
createTask — 提交生成任务

On this page