原图（小木屋）
竖版插画角色参考
合成结果2 张参考图 / 1024 × 768
在扶手椅上睡着
只在蒙版区域重绘：角色盖着毯子睡在扶手椅上，小木屋其余部分保持原样。
Prompt · English
The explorer character curled up in the armchair asleep under a knitted blanket
用原图、蒙版和 1 张角色参考图，把同一个角色局部重绘进已有画面，其余部分保持不变。在 HiAPI 在线试用并查看前后对照、计费说明与 API 示例。
提供商: Ideogram
类型: 图像生成
接口: /v1/tasks
状态: 已开放
消耗: 查看页面实时价格
返回模型列表
Ideogram 3.0 Character Edit
提供商 Ideogram图像
用原图、蒙版和 1 张角色参考图，把同一个角色局部重绘进已有画面，其余部分保持不变。在 HiAPI 在线试用并查看前后对照、计费说明与 API 示例。
定价
标准用量
260 积分/ 张
输入
0 / 5000
更多参数
上传素材
上传后可预览0/1
上传 1 张角色清晰的图片（插画或照片）；生成时输出宽高比跟随这张图
黑色区域会被重绘、白色保留，需与原图宽高比一致
生成设置
TURBO 最快、BALANCED 默认、QUALITY 细节最好，三档分别计价
AUTO 自动；REALISTIC 写实；FICTION 插画 / 虚构风格
生成偏好
用 MagicPrompt 自动扩写提示词
高级参数
用于复现结果 · 整数 · 范围：0 - 2147483647，必须是整数
预估费用260 积分 / 张BALANCED
请先上传蒙版
输出
准备生成
配置参数并点击"运行"查看输出结果。
--
参考图如何变成编辑结果
每个案例分别展示参考图、编辑指令和完整结果，支持放大图片与复制提示词。
原图（小木屋）竖版插画角色参考合成结果原图（小木屋）竖版插画角色参考
合成结果2 张参考图 / 1024 × 768
窗边挥手
换一张蒙版，把同一个角色放到窗边挥手，构图与光线沿用原图。
Prompt · English
The explorer character standing by the window waving at the camera
原图（小木屋）
横版照片人物参考
合成结果2 张参考图 / 1024 × 768
照片人物坐进小木屋
照片人物参考 + 蒙版：同一个人坐进小木屋读书，输出尺寸跟随原图 1024×768。
Prompt · English
The same man sitting in the armchair reading a hardcover book, relaxed, warm lamp light on his face
相关图像模型
根据任务类型、输出档位和参考图需求选择相邻模型。
关于 Ideogram 3.0 Character Edit
用原图、蒙版和 1 张角色参考图，把同一个角色局部重绘进已有画面，其余部分保持不变。在 HiAPI 在线试用并查看前后对照、计费说明与 API 示例。
本页 Playground 和 API 使用同一个模型 ID：ideogram-v3-character/edit。参考图提供人物、产品、场景或风格事实，提示词负责分配每张图的作用并限定修改范围。
- 提供商
- Ideogram
- 任务
- 图生图 / 图片编辑
- 参考图
- 1
- 价格
- 查看实时价格
模型规格
为 Ideogram 3.0 Character Edit 选择适合创作目标的输入与输出设置。
- 参考图数量
- 1
- 输出格式
- WEBP
- 渲染档位
- TURBOBALANCED（默认）QUALITY
- 风格
- AUTOREALISTICFICTION
- 必填素材
- 原图 + 蒙版 + 1 张角色参考图
- 输出尺寸
- 跟随原图
- 提示词长度
- 1–5000 个字符
- 价格
- 查看实时价格
每次固定输出 1 张图片；角色参考图、原图与蒙版不另收费。失败任务不扣费，以页面实时价格为准。
如何使用 Ideogram 3.0 Character Edit
参考图负责提供事实，提示词负责分配每张图的角色并限定修改范围。
原图
蒙版
角色
01
准备原图、蒙版与角色参考
蒙版与原图宽高比一致：白底上用黑色涂出角色要出现的区域，略大于角色轮廓。
蒙版内：角色与动作
蒙版外：原图不变
02
写清动作，保留其余画面
描述角色在蒙版区域里的动作和道具；蒙版外的背景、光线与构图会保持原样。
Playground
POST /v1/tasks
03
对比结果后接入 API
在 Playground 拖动对比原图与结果，满意后用同一模型 ID 创建异步任务。
API 快速接入
下面是可直接复制的最小请求；完整参数、回调、查询与错误码请查看 Docs。
- 接口
POST /v1/tasks- 模型 ID
ideogram-v3-character/edit
cURL
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v3-character/edit",
"input": {
"prompt": "The explorer character curled up in the armchair asleep under a knitted blanket",
"image_url": "https://static.hiapi.ai/gallery/2026/10/8e1328c02f8edd33.jpg",
"mask_url": "https://static.hiapi.ai/gallery/2026/10/0121b5b1d8af8697.png",
"reference_image_urls": [
"https://static.hiapi.ai/gallery/2026/10/12ccfec91203bec9.jpg"
],
"rendering_speed": "TURBO"
}
}'创建请求会立即返回 taskId；图像生成在后台异步完成。
蒙版局部重绘
Ideogram 3.0 Character Edit：只在蒙版里画进同一个角色
Character Edit 面向“画面已经有了，只差角色”的情况：提交原图、一张同宽高比的蒙版和 1 张角色参考图，模型只重绘蒙版的黑色区域，把参考图里的角色画进去，蒙版外的背景、光线和构图保持原样。
蒙版决定角色出现的位置和大致大小，提示词只需描述角色在这块区域里的动作和道具。输出尺寸跟随原图，每次 1 张。
- 原图 + 蒙版 + 1 张角色参考图
- 只重绘蒙版黑色区域
- 输出尺寸跟随原图
- TURBO / BALANCED / QUALITY
案例横览
同一间小木屋，三次局部重绘
原图都是同一张小木屋，只换蒙版位置和角色参考图；提示词只写角色在蒙版里的动作，可直接复制。
4:3在扶手椅上睡着
The explorer character curled up in the armchair asleep under a knitted blanket
4:3窗边挥手
The explorer character standing by the window waving at the camera
4:3照片人物坐进小木屋
The same man sitting in the armchair reading a hardcover book, relaxed, warm lamp light on his face
蒙版局部编辑
三样素材，一次局部重绘
ideogram-v3-character/edit 需要三样素材：原图、与原图宽高比一致的蒙版，以及 1 张角色参考图。蒙版黑色区域会被重绘，白色部分保留原图；输出尺寸跟随原图。
- 01
准备原图与蒙版
蒙版与原图宽高比一致，白底上用黑色涂出角色要出现的位置，区域略大于角色轮廓。
- 02
选择角色参考图
插画或照片都可以，只传 1 张，角色主体要清晰。
- 03
描述动作与姿态
提示词写角色在蒙版里做什么，例如坐进扶手椅读书或在窗边挥手。
前后对比
拖动对比：只有蒙版里的区域被重绘
每组都是原图、蒙版和 1 张角色参考图一起提交。蒙版的黑色区域被重绘成角色，白色区域保留原图；拖动滑块可以看到货架、灯光、雨夜街景和小木屋陈设都没有变化。
面包店柜台 · 吉祥物角色 · 蒙版 + 角色参考图
雨夜公交站 · 绘本角色 · 蒙版 + 角色参考图
小木屋扶手椅 · 插画角色 · 蒙版 + 角色参考图同一原图，换一张蒙版
蒙版画在哪里，角色就出现在哪里
原图和角色参考图都不变，只更换蒙版位置和动作提示词：蒙版涂在中间的扶手椅上、提示词写睡觉，角色睡进椅子；蒙版涂在左侧窗边、提示词写挥手，角色站到窗前挥手。蒙版外的家具、光线和构图保持原样。
哪些画面适合局部重绘
门店与商品场景
已有门店或陈列图不想重拍，只在空位涂蒙版放入吉祥物。
插画补角色
背景插画已经定稿时，用蒙版把主角补进指定位置。
同一场景多个版本
同一张原图换不同蒙版，得到角色在不同位置、不同动作的版本。
适合哪些编辑流程
当背景已经定稿、只需要把角色放进某个位置时，局部重绘比整张重新生成更可控。
门店、陈列与商品图
在现成的门店或陈列照片里涂出空位，放入品牌吉祥物，货架和灯光不用重拍。
示例：面包店柜台
插画与绘本补角色
背景插画已经画好时，用蒙版把主角补进长椅、窗边等指定位置。
示例：雨夜公交站长椅
同一场景出多个版本
同一张原图换不同蒙版，得到角色在不同位置、不同动作的版本，方便挑选。
示例：小木屋扶手椅与窗边
画蒙版前需要知道的
以下要点对应本页的局部重绘案例。
- 宽高比必须一致
- mask_url 与 image_url 的宽高比必须相同，否则请求会被拒绝；输出尺寸跟随原图。
- 黑色重绘，白色保留
- 黑色区域会被重绘成角色，白色区域保留原图；区域略大于角色轮廓，边缘过渡更自然。
- 三项素材都必填
- 原图、蒙版和 1 张角色参考图缺一不可；只想用参考图生成新画面，请使用 Character 生成模型。
相关模型
CHARACTER
没有原图？用 Character 直接生成新场景
1 张角色参考图加提示词，即可把角色放进任意新画面。
IDEOGRAM V4
需要海报文字和版式？了解 Ideogram V4
标题、Logo 与标牌等文字排版场景可以进一步比较。
在 HiAPI 试用 Character Edit
在上方 Playground 分别上传原图、蒙版和角色参考图即可试用；接入时使用模型 ID ideogram-v3-character/edit，通过 HiAPI /v1/tasks 接口提交，按张计费、失败不扣费。
需要比较不同模型和计费档位？查看全部模型实时价格
常见问题
蒙版有什么要求？
蒙版需与原图宽高比一致，黑色区域会被重绘、白色部分保留。区域略大于角色轮廓更自然。
输出尺寸是多少？
输出跟随原图尺寸，例如 1024×768 的原图得到 1024×768 的结果。
原图里已有人物，可以替换吗？
可以，把要替换的人物涂进蒙版，并在提示词中描述新角色的动作；蒙版外的人物与背景会保留。
蒙版用什么格式？
用一张和原图宽高比相同的图片，白底上用黑色涂出要重绘的区域；本页案例使用 PNG 蒙版。
蒙版画多大合适？
比角色轮廓略大一圈即可。太小会挤压角色姿态，太大则会重绘更多背景。
提示词应该写什么？
只写角色在蒙版区域里做什么，例如“坐在长椅上撑伞”“站在窗边挥手”；不需要再描述背景，蒙版外的画面会保持原样。
同一张原图可以放到不同位置吗？
可以。原图和角色参考图不变，更换蒙版位置和动作提示词即可，本页小木屋的扶手椅和窗边两个版本就是这样得到的。
可以不传蒙版吗？
不可以。image_url、mask_url 和 reference_image_urls 都是必填；没有原图时请使用 Character 生成模型。
可以传多张角色参考图吗？
不可以。reference_image_urls 必须恰好 1 张，插画、吉祥物和写实照片都可以。
rendering_speed 和 style 在编辑里也能用吗？
可以。TURBO / BALANCED / QUALITY 三档与 AUTO / REALISTIC / FICTION 风格同样适用；三档按张分别计价，具体价格见页面实时价格。
支持 Remix 吗？
暂不支持。当前开放角色生成（ideogram-v3-character）和蒙版局部编辑（ideogram-v3-character/edit）。
失败会扣费吗？如何获取结果？
失败任务不扣费。提交后保存 taskId，通过 GET /v1/tasks/:id 查询，status 为 success 后从 output[].url 下载 WebP；output[].url 是临时地址，请及时保存。