Ideogram-V3 Edit API 调用完全手册

Ideogram‑V3 Edit

Ideogram‑V3 Edit 是 Ideogram 3.0 模型的图像局部编辑（Inpainting）接口，核心是用蒙版指定区域、用提示词重绘该区域，同时保留原图其余部分不变。

一、核心定位与能力

• 核心功能：基于蒙版的局部图像编辑（Inpainting）
  • 上传原图 + 蒙版（白色=要编辑区域）
  • 用提示词描述蒙版区域的新内容
  • AI 重绘蒙版区，其余像素保持原样
• V3 增强
  • 更高真实感、光影与细节还原
  • 精准文本渲染（适合海报、Logo 编辑）
  • 支持角色一致性（Character Reference）
  • 可搭配风格参考、背景替换、换脸等场景

二、API 调用（官方 / 第三方）

1. 官方 Edit V3 接口

• Endpoint：https://api.ideogram.ai/v3/edit
• 请求方式：POST（multipart/form-data）
• 必填参数
  • image：原图文件（JPG/PNG/WebP，≤10MB）
  • mask：蒙版文件（与原图同尺寸，白色=编辑区）
  • prompt：描述蒙版区内容的提示词
• 可选参数
  • rendering_speed：生成速度（FAST/BALANCED/QUALITY）
  • magic_prompt：自动优化提示词（ON/OFF/AUTO）
  • seed：随机种子（0–2³¹‑1，复现结果）
  • num_images：生成数量（默认 1）
• 响应：返回编辑后图像 URL（有效期 24 小时）
• 【OpenAI】获取OpenAI API Key的多种方式全攻略：从入门到精通，再到详解教程！

2. 第三方封装示例（Fal.ai）

• Endpoint：https://fal.run/fal‑ai/ideogram/v3/edit
• 参数：image_url、mask_url、prompt为必填
• 示例请求

{"image_url":"https://example.com/original.jpg","mask_url":"https://example.com/mask.png","prompt":"A golden retriever wearing a red bandana","rendering_speed":"BALANCED","num_images":1}

三、使用流程（通用）

1. 准备原图与蒙版（同尺寸，白色标记要修改区域）
2. 构造提示词，描述蒙版区的目标内容
3. 调用 Edit 接口，传入原图、蒙版、提示词
4. 获取并下载编辑后的图像

四、适用场景

• 局部替换：给人物换衣服、给场景加物体
• 文本编辑：修改海报文字、Logo 内容
• 背景局部调整：替换天空、添加道具
• 角色一致性编辑：保持人物面部/发型不变，修改服装/场景

五、与 Ideogram‑V3 Remix 的区别

• Edit：蒙版+局部重绘，精准控制修改范围，保留其余部分
• Remix：全图风格/内容调整，无蒙版，整体重绘，保留原图结构