使用介绍
/
指令编辑
Last updated

指令编辑 新功能标志

用自然语言改图：指定参考图，写清「想怎么改」，例如「把这张图改成插画风」「让侧视图变成正视图」。

通过 指令编辑（POST /v1/tob/edit-diffusion）提交。--edit 仅该接口支持，其它接口携带会被拒绝。

仅 V8.1 / V8.2模型支持，请在提示词中明确指明

能做什么

场景做法
整图按指令修改 / 多图融合--edit 指定 1–4 张图，文本写如何修改
只改画面某一块（擦除、替换、外扩）待改区域做成透明，并打开 withTransparentMask

与垫图不同：垫图描述最终画面；--edit 写的是改图指令。打开透明遮罩后，效果等同于区域重绘 / 编辑 / 高级编辑。

接口参数说明

字段类型必填说明
promptstring是提示词，长度 [1-8096]。需包含修改指令；用 --edit 指定图片
jobIdstring否引用的任务ID
imageNoint提供 jobId 时必填图片编号 [0-23]
withTransparentMaskbool否是否把 --edit 图片中的透明区域识别为待编辑区，默认 false
callbackstring否任务结果回调 URL

提示

当某个任务的单张图片进行操作时，建议传入 jobID 和 imageNo，这样模型可以更稳定的参照原图内容进行图片生成

提示词规则

<修改指令> --edit <图片URL> [图片URL...] --v 8.1
规则说明
格式--edit 后跟 1–4 个图片 URL，空格分隔，不要用逗号
不能为空--edit 后面没有 URL 会返回 400
不能重复重复 URL 会返回「重复参数」
数量上限最多 4 张，超出返回「图片数量不能超过4张」
不合并垫图提示词开头的垫图不会并入 --edit；编辑对象必须写在 --edit 后面
必须有文本要写「如何修改」；多图时写清各图用途（人物 / 服装 / 场景等）
图片格式png / jpg / jpeg / webp；单张 ≤ 20MB，边长 ≤ 16k。透明遮罩须用带 Alpha 的 PNG
其它参数可叠加 --ar、--s、--seed、--hd、--sref / --sw、--p 等
把这张图改成插画风 --edit https://example.com/photo.png --v 8.1
结合第一张的人物、第二张的服装，生成一张完整画面 --edit https://a.example.com/person.png https://b.example.com/outfit.png --v 8.1

局部编辑

设置withTransparentMask参数时，模型把 --edit 图里的透明像素当成「请重绘这里」的遮罩，而不是画面内容。

Alpha含义
< 128待编辑区，按提示词重绘
≥ 128保留区，构图和主体尽量不变

何时打开： 局部替换、擦除后重绘、把原图缩小/平移后周围露出透明底。整图改风格时保持默认 false，以免半透明像素被当成遮罩。

图片要求： 必须是带 Alpha 的 PNG（JPG 无效）；待编辑图画在 --edit 第一张

{
  "prompt": "把透明背景换成黄昏海边，保留人物姿态 --edit https://example.com/person-with-hole.png --v 8.1",
  "withTransparentMask": true
}

其它示例

基于已有任务：

{
  "jobId": "12345",
  "imageNo": 0,
  "prompt": "改成赛博朋克夜景，保留主体 --edit https://example.com/person-with-hole.png --v 8.1"
}

叠加风格参考：

把人物换成商务正装，整体改为水彩插画风格 --edit https://example.com/person.png --sref https://example.com/watercolor.png --sw 200 --v 8.1