扩图 / 外扩 用于把图片边界向外扩展，自动补全画面外的背景、光影和场景。它是桌面端本地内置 AI 创作能力，出现在「常用智能能力 / 图片加工」中。
| 方式 | 怎么用 | 适合人群 |
|---|
| 可视化编排（推荐） | 拖入 扩图 / 外扩，选择输入图和目标分辨率 | 需要把图片改成横版、竖版或更大画布的用户 |
| 代码编排（执行指令 XML） | 通过 ImageExtend 动态传入图片和尺寸 | 需要批量扩图的用户 |
- 将方图扩成横幅、竖版海报或更大尺寸。
- 为商品图、海报图补全边缘背景。
- 保持主体不变，只扩展周围环境。
- 必须提供
images 输入图。
- 目标分辨率建议与原图比例接近，避免扩展过度。
- 如要保持主体居中，可在补充要求里明确说明。
| 界面名称 | 代码属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|
| 输入图 | images | File / URL | 是 | - | 要外扩的原图。 |
| 模型 | model | String | 否 | seedream-4.0 | 需支持图像编辑。 |
| 目标分辨率 | size | String | 否 | 模型默认 | 例如 1920x1080、1080x1920。 |
| 补充要求 | prompt | String | 否 | - | 例如“保持主体不变，向左右自然延展背景”。 |
| 随机种子 | seed | String / Number | 否 | - | 用于尽量复现结果。 |
| 输出目录 | outDir | Directory | 否 | 默认输出目录 | 保存扩图结果的位置。 |
| 将结果保存至 | outKey | Output | 是 | 当前节点 | 保存结果对象。 |
核心输出为 images 数组，每项包含 url、localPath、revisedPrompt。
- 输出图尺寸符合目标设置。
- 原图主体保持不变，没有明显拉伸或变形。
- 外扩区域与原图风格、光影和透视自然衔接。
| 报错 / 现象 | 可能原因 | 处理建议 |
|---|
image-to-image 模式需要 images/image 参数 | 未提供输入图 | 添加原图后重试。 |
| 主体被改动 | 扩图要求不明确 | 在补充要求中写明“保持主体不变”。 |
| 外扩区域不自然 | 尺寸变化过大 | 分多次扩展，或选择更接近原比例的尺寸。 |
images="/Users/example/poster.png"
prompt="保持主体不变，向左右自然延展背景"
