快速迭代
先在 Playground 验证提示词，再把 createTask 接入你的应用。
在线试用
在集成前用 Playground 验证提示词与参数，输出与生产 API 一致。
请求参数
createTask 的 input 字段说明（默认 Tab）。
| 字段 | 类型 | 必填 |
|---|---|---|
| prompt | textarea | 是 |
| aspect_ratio | select (1:1 | 16:9 | 9:16) | 否 |
| image_url | file | 是 |
输出示例
典型生成效果预览（实际输出因提示词而异）。
Preview
性能优势
团队选择该模型用于生产工作流的原因。
功能亮点
该模型在 ModKie 网关下的核心能力。
文生图生产管线
通过 createTask 提交 prompt 与长宽比等参数，异步轮询 recordInfo 获取图像 URL。
Playground 零代码验证
在浏览器内调试提示词与参数，确认输出后再复制 JSON 到生产环境。
可构建的应用
开发者与产品团队常见的 API 使用场景。
营销创意素材
用文本提示词生成广告静图、主视觉与社交媒体素材。
定价
按成功任务扣积分；下方为单次任务估算。
共享 API
20 积分 / 次
约 $0.10 USD（按 $0.01 USD/积分 套餐汇率）
快速开始
从 API Key 到首次成功任务的三步流程。
- 1
创建 API Key
登录后在 设置 → API Keys 创建密钥。
- 2
提交 createTask
向 /api/v1/jobs/createTask 发送模型 ID 与 input 载荷。
- 3
轮询 recordInfo
轮询 recordInfo 直至任务完成，从响应中获取输出。
createTask 请求示例
curl -X POST https://modkie.com/api/v1/jobs/createTask \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-api",
"input": {
"prompt": "Transform the reference image into a watercolor illustration while preserving the original composition.",
"image_input": [
"/playground/samples/google-imagen4/image.webp"
],
"aspect_ratio": "16:9"
}
}'轮询 GET /api/v1/jobs/recordInfo?taskId=… 直至 success 或 fail。仅成功任务扣积分。
常见问题
为什么选择 ModKie
ModKie 不仅是 API 转接 — 还可部署、微调，并将自定义端点注册到同一网关。
统一网关
一个 API Key 与 jobs 契约，覆盖市场模型与自托管模型。
Playground
上线前在浏览器内验证请求载荷。
RunPod 自部署
部署 HuggingFace 或自定义 Worker，经 ModKie 路由流量。
训练与注册
视觉模型微调后将权重注册回网关。
落地支持
与团队协作完成模型落地、集成与生产上线。
适合谁
- 开发者 — Playground、文档与可预期的异步计费，快速交付功能。
- 企业团队 — 多 Provider 统一契约、用量仪表盘与 Webhook。
- 微调与自有权重 — 训练自定义模型后，仍用相同 createTask 流程对外服务。