入门指南

按步骤接入统一异步任务 API,调用 100+ 模型。

1

选择模型

打开模型市场,按提供商与任务类型筛选。优先了解 ModKie 自部署模型(同一套 Jobs API,生产默认参数)。进入模型页可试用 Playground,并查看参数说明。

2

创建 API 密钥

登录后在 API 密钥页创建密钥。生产环境建议配置速率限制与 IP 白名单。切勿在前端代码中暴露密钥。

3

调用 createTask

使用 Bearer 认证请求 POST /api/v1/jobs/createTask。返回 200 表示任务已入队;失败任务不扣费。可在示例页复制现成 payload。

4

轮询 recordInfo

请求 GET /api/v1/jobs/recordInfo?taskId=... 直至 state 为 success 或 fail,再下载结果中的媒体 URL。

5

速率与回调

建议控制突发创建速度(约每 10 秒不超过 20 个新任务)。生产环境优先使用 Webhook,而不是高频轮询。

ModKie 入门指南 — AI API 平台