Ideogram 4.5 Edit API

ideogram/v4.5/edit
image_urls · mask_url · reference_image_urls

Ideogram 4.5 Edit 将一张源图和文字指令转化为修改后的图片,支持可选遮罩、最多 4 张参考图与高编辑精度。它会保留未要求修改的区域,多轮编辑后依然贴近原图。

获取 API Key
Input
必填169/10000
必填
Image Urls

拖拽文件、粘贴剪贴板素材,或输入 URL。 恰好一张源图(公开 HTTP(S) URL)。

1/1 个素材

可选
Mask Url

拖拽文件、粘贴剪贴板素材,或输入 URL。 可选遮罩,尺寸与源图一致:黑色 = 修改,白色 = 保留。需要 size 为 auto。

可选
Reference Image Urls

拖拽文件、粘贴剪贴板素材,或输入 URL。 最多 4 张参考图,设置遮罩时最多 3 张。仅用于引导,不会被编辑。

可选
可选
可选
可选
Output已就绪

预计费用: 12 credits · $0.0600

提交任务时预扣积分,任务失败将全额退还。

继续使用

示例

output-01.png

Replace the masked sky with a clear late-afternoon sky with a few soft clouds. Keep the house, garden and shadows unchanged.

output-01.png

Place the ceramic mug from the source image on a linen tablecloth in the morning-light kitchen shown in the reference image. Keep the mug shape, glaze colour and handle exactly as in the source.

Ideogram 4.5 Edit

Ideogram 4.5 Edit 是 Ideogram 4.5 的编辑端点,Ideogram 将其定位为旗下最精确的编辑模型。它接收一张源图、最长 10,000 字符的指令、可选的黑白遮罩,以及最多 4 张只用于引导风格或内容、本身不会被编辑的参考图。四档画质最低 1.6 积分,默认尺寸 auto 保持源图尺寸。

为什么选择 Ideogram 4.5 Edit?

  • 基于指令的精确编辑用自然语言描述修改内容;Ideogram 表示 4.5 的设计目标是在多轮编辑中避免像素偏移与颜色漂移。

  • 遮罩限定修改区域通过 mask_url 限定编辑范围:黑色为修改区域,白色为保留区域。带遮罩的编辑使用 size auto。

  • 参考图只引导、不被修改最多添加 4 张 reference_image_urls(使用遮罩时为 3 张)来引导风格、物体或场景,只有源图会被编辑。

  • 高编辑精度将 edit_precision 设为 high,未修改的像素会从源图恢复,只有要求的变化不同。

  • 四档画质,1.6 积分起very_low、low、medium、high 每张分别为 1.6、6、12、44 积分;遮罩、参考图与尺寸都不影响价格。

参数

参数要求说明
prompt必填

编辑指令,非空,最多 10,000 个字符。

image_urls必填

恰好一张源图,以包含 1 个公开 HTTP(S) URL 或图片 data URI 的数组提供。

mask_url可选

可选遮罩,尺寸与源图一致:黑色 = 修改,白色 = 保留。需要 size 为 auto。

reference_image_urls可选

0–4 张参考图(设置 mask_url 时为 0–3 张),用于引导结果,本身不会被编辑。

edit_precision可选

regular 或 high。high 需要 size 为 auto。

默认值regularhigh
quality可选

very_low、low、medium 或 high,决定每张价格。

默认值mediumvery_lowlowhigh
n可选

图片数量,整数 1–8。

默认值1
size可选

auto 保持源图尺寸;也可用预设(1:1、1:1 HD、4:3、3:4、16:9、9:16)或 WIDTHxHEIGHT(边长 ≥256 且为 32 的倍数,总像素 ≤4,194,304,比例 ≤6:1)。使用遮罩或高精度时必须为 auto。

默认值auto

使用方法

  1. 准备源图使用一张公开图片 URL。需要局部修改时,再准备一张宽高相同的遮罩,在要修改的位置涂黑。

  2. 撰写指令说明要改什么、哪些必须保留;如需借鉴风格、产品或场景,添加参考图。

  3. 选择精度、画质与尺寸细小的定点修改使用 high 编辑精度;除非需要新画幅,保持 size 为 auto,并选择画质档位。

  4. 提交并获取结果将 model 设为 ideogram/v4.5/edit 发送到提交端点,再用 task_id 轮询或等待 callback_url 读取编辑结果。

用量与计费

按输出图片数量和画质计费,总积分 = 单价 × n。1 积分 = $0.005。

提交任务时预扣积分,任务失败全额退还。遮罩、参考图、编辑精度与尺寸都不影响价格。

用量与计费
选项积分 / 张美元 / 张
very_low1.6$0.008
low6$0.03
medium12$0.06
high44$0.22

最佳使用场景

  • 包装与标识本地化替换标签、菜单板或招牌上的文字,材质、光线与透视保持拍摄原样。

  • 商品换景保留源图中的商品,借助参考图将其放入新场景,用于商品页或广告。

  • 室内软装改造用遮罩框出沙发、墙面或地板进行改造,房间其余部分保持不变。

  • 应用内编辑功能让用户在应用中涂抹区域,作为 mask_url 发送,一次 API 调用即可返回编辑结果。

使用技巧

  • 遮罩规则:遮罩需与源图尺寸一致并同时包含黑白两色;黑色区域被修改,白色区域被保留。
  • 遮罩会占用一个参考图名额,发送 mask_url 时参考图最多 3 张。
  • 连续编辑时,把完成结果的 URL 作为下一次请求的 image_urls;每一步单独计费。
  • 先用 very_low 快速验证指令,再用 medium 或 high 重跑同一请求。

注意事项

  • image_urls 必须恰好包含一张图片,其他图片请放入 reference_image_urls。
  • 发送 mask_url 或 edit_precision 为 high 时,size 不是 auto 会返回 400。
  • 自定义尺寸的边长需 ≥256 像素且为 32 的倍数,总像素不超过 4,194,304,宽高比不超过 6:1。

相关模型

Ideogram 4.5 Edit API 常见问题

Ideogram 4.5 Edit API 是什么?

Ideogram 4.5 Edit 是 Ideogram 用于根据文字指令编辑已有图片的模型。它可对一张源图进行修改,支持可选遮罩、最多 4 张参考图以及 regular 或 high 编辑精度,按四档画质单次返回 1–8 张结果。Ideogram 的设计目标是让未修改区域保持稳定,多轮编辑不累积漂移。你可以通过 API 进行程序化调用,也可以在上方体验区直接在线试用。

Ideogram 4.5 Edit 的遮罩怎么用?

遮罩需与源图宽高一致,并同时包含黑色和白色。黑色表示要修改的区域,白色表示保留的区域。带遮罩的请求必须使用 size auto。

Ideogram 4.5 Edit 支持几张参考图?

reference_image_urls 最多 4 张,设置 mask_url 时最多 3 张。参考图只用于引导,不会被编辑;要编辑的单张图片放在 image_urls 中。

Ideogram 4.5 Edit 的高编辑精度有什么作用?

edit_precision 设为 high 时,未改动的像素会从源图恢复,只有要求的变化不同。它需要 size 为 auto。

Ideogram 4.5 Edit 怎么收费?

每张输出图片:very_low 1.6 积分($0.008),low 6 积分($0.03),medium 12 积分($0.06),high 44 积分($0.22)。总价 = 单价 × n;遮罩、参考图、精度与尺寸不影响价格。

Ideogram 4.5 Edit 能改变输出尺寸吗?

不带遮罩的 regular 编辑可以:使用预设或自定义 WIDTHxHEIGHT(边长 ≥256 且为 32 的倍数,总像素 ≤4,194,304,比例 ≤6:1)。默认 auto 保持源图尺寸。

如何用 Ideogram 4.5 Edit 进行多步编辑?

把上一步完成结果的 URL 作为下一次请求的 image_urls,只描述下一处修改。每一步都是独立任务,按画质 × n 计费。

Ideogram 4.5 Edit 能替换照片中的文字吗?

可以。在指令中用引号写出新文字,并说明替换哪块招牌或标签;在该区域加上遮罩,可让照片其余部分保持不变。