这一项共 6 个参数，其中必填的是 prompt、ref_images。参数名、取值范围与默认值以本页下方的目录为准：接口按这份契约严格校验，未知参数直接报错，不会静默丢弃。
调用方式是「提交即返回任务号、再轮询取结果」：文本与图片类通常十几秒到一分钟，视频类一条按分钟计。排队中的任务会给出队列位置，那不代表失败。
这一项可以指定 model：不传就走默认档。可选档位：
zimage（默认）qwen2512krea2
参数契约
| 参数 | 必填 | 说明 | 取值与边界 |
|---|---|---|---|
prompt | 必填 | 画面提示词 | string |
ref_images | 必填 | 参考图数组，1–5 张；model=krea2 时最多 3 张 | material_list；kind=image；数量≤5 |
count | 可选 | 生成张数，1–4 | integer；≤4；≥1；默认 1 |
width | 可选 | 输出宽度（像素） | integer；≤7680；≥64 |
height | 可选 | 输出高度（像素） | integer；≤7680；≥64 |
style | 可选 | 画风：default=默认 / none=无风格 / cinematic=写实电影感 / gufeng=古风 / anime=动漫 / comic=漫画 / cartoon=卡通 / 3d=3D渲染 / hand_drawn=手绘 / ink=水墨 / dreamy=梦幻 / film=复古胶片 / oil_painting=油画 / watercolor=水彩 / sketch=素描 / studio_photo=写实写真 / cyberpunk=赛博朋克 / pixel_art=像素艺术 / paper_cut=纸雕 / silent_film=黑白默片 / documentary=纪录片纪实 / vaporwave=蒸汽波 / claymation=粘土定格 / guoman=国漫 / low_poly=低多边形 / mono_manga=黑白漫画；缺省用部署默认画风 | string；或：default/none/cinematic/gufeng/anime/comic/cartoon/3d/hand_drawn/ink/dreamy/film/oil_painting/watercolor/sketch/studio_photo/cyberpunk/pixel_art/paper_cut/silent_film/documentary/vaporwave/claymation/guoman/low_poly/mono_manga |
调用示例
{
"task_type": "image_edit",
"params": {
"prompt": "把参考图角色改成赛博朋克风格",
"ref_images": [
{
"url": "https://example.com/ref.png"
}
],
"style": "cinematic"
}
}常见问题
- 图生图怎么计费？
- 按「image_gen」这一计费项从账户余额扣除。提交时按最低档预扣，跑完按实际用量结算；任务失败不计费，预扣部分解冻回余额。
- 生成的文件在哪里？
- 任务完成时在结果里给出签名直链，图片、视频、音频都是这个形式。直链 24 小时过期，需要长期留存请自行转存。
- 可以直接在网页上用吗？
- 可以。自由工作台与短剧流水线里都有这一项的界面入口，接口与 MCP 是给系统和智能体调用的同一能力。