ERNIE-Image

ERNIE-iRAG Edit 百度官方图像编辑 API 实战：消除、重绘与变体生成完全指南

Jun 28, 2026

ERNIE-iRAG Edit 百度官方图像编辑 API 实战：消除、重绘与变体生成完全指南

摘要：百度千帆平台正式上线 ERNIE-iRAG-Edit 图像编辑模型 API，支持 erase（消除对象）、repaint（重绘对象）和 variation（生成变体）三大核心功能，定价 0.14 元/张。虽然这不是开源的 ERNIE-Image 编辑模型，但作为百度官方图像编辑能力的 API 化，它填补了 ERNIE 生态中长期缺失的图像编辑能力。本文从零开始讲解 API 调用方法、三种编辑模式的最佳实践，以及与 FLUX Kontext 等社区替代方案的对比。

编辑功能终于来了

ERNIE-Image 社区对编辑功能的期待由来已久。从 2026 年 5 月开始，Reddit 上关于"ERNIE 编辑模型何时发布"的讨论持续升温，279 个点赞的帖子成为社区焦点。虽然开源的 ERNIE-Image 编辑模型仍在开发中，但百度通过千帆 API 先行释放了 ERNIE-iRAG-Edit 的编辑能力——以 API 服务而非开源模型的形式。

关键信息：

  • 模型：ERNIE-iRAG-Edit（百度自研图像编辑模型）
  • API 价格：0.14 元/张（约 $0.02/张）
  • 端点：POST /v2/images/edits
  • 鉴权：API Key（BCE V3 签名）
  • 支持模型：ernie-irag-edit、qwen-image-edit

三大编辑模式详解

ERNIE-iRAG-Edit 提供三种核心编辑功能，每种适用于不同的编辑场景。

1. Erase（消除对象）

消除图片中遮罩选中的对象，适用于移除不需要的元素。

调用参数：

  • feature: "erase"
  • image: 原始图片 URL 或 Base64
  • mask: 遮罩图片（白色像素 = 消除区域，黑色像素 = 保留区域）
  • prompt: 可选（erase 模式下可不传）

输出尺寸规则：保持原图比例。短边 < 512 时保留 512；长边 > 1280 时截断至 1280。例如输入 500×1000 的图片，输出为 512×1024。

适用场景：

  • 移除照片中的路人或干扰物
  • 清除产品图中不需要的背景元素
  • 擦除水印或不需要的装饰元素

2. Repaint（重绘对象）

根据输入的 prompt 重新绘制遮罩选中的区域，适用于局部修改。

调用参数：

  • feature: "repaint"
  • image: 原始图片
  • mask: 遮罩图片（白色像素 = 重绘区域）
  • prompt: 必填，描述重绘后的内容

适用场景：

  • 修改人物的服装或发型
  • 替换背景中的特定元素
  • 丰富局部细节（如增加装饰、调整颜色）
  • 主题替换（如将猫改为狗）

3. Variation（生成变体）

参考输入的 prompt 与 image 生成新的图片，保持参考图的背景、人物服饰、姿态等特征。

调用参数：

  • feature: "variation"
  • image: 参考图片（无需 mask）
  • prompt: 必填，描述期望的变体

输出尺寸规则：保持原图宽高比，缩放至总像素 1048576（1024×1024），边长均为 16 的倍数，最长边 ≤ 1440。

适用场景：

  • 保持角色特征生成不同场景的照片
  • 产品图的场景变体（同一产品不同背景）
  • 保持构图生成风格化版本

API 调用实战

Python 调用示例

import requests
import json

def edit_image(api_key, feature, image_url, prompt="", mask_url=None):

"""

ERNIE-iRAG-Edit API 调用


参数:
    api_key: 百度千帆 API Key
    feature: &quot;erase&quot; / &quot;repaint&quot; / &quot;variation&quot;
    image_url: 原始图片 URL
    prompt: 正向提示词（erase 模式可省略）
    mask_url: 遮罩图片 URL（variation 模式不需要）
&quot;&quot;&quot;
url = &quot;https://qianfan.baidubce.com/v2/images/edits&quot;

payload = {
    &quot;model&quot;: &quot;ernie-irag-edit&quot;,
    &quot;image&quot;: image_url,
    &quot;feature&quot;: feature,
}

if prompt:
    payload[&quot;prompt&quot;] = prompt

if mask_url and feature in [&quot;erase&quot;, &quot;repaint&quot;]:
    payload[&quot;mask&quot;] = mask_url

headers = {
    &#39;Content-Type&#39;: &#39;application/json&#39;,
    &#39;Authorization&#39;: f&#39;Bearer {api_key}&#39;
}

response = requests.post(url, headers=headers, json=payload)
return response.json()



使用示例：消除对象


result = edit_image(

api_key="your-api-key",

feature="erase",

image_url="https://example.com/original.jpg&quot;,

mask_url="https://example.com/mask.jpg&quot;

)


使用示例：重绘对象


result = edit_image(

api_key="your-api-key",

feature="repaint",

image_url="https://example.com/original.jpg&quot;,

prompt="更换为蓝色牛仔裤",

mask_url="https://example.com/leg-mask.jpg&quot;

)


使用示例：生成变体


result = edit_image(

api_key="your-api-key",

feature="variation",

image_url="https://example.com/product.jpg&quot;,

prompt="将产品放在自然户外场景中，阳光明媚"

)

Base64 格式上传

如果图片不在公网 URL 上，可以使用 Base64 编码上传：

import base64

def image_to_base64(image_path):

with open(image_path, "rb") as f:

return f"data:image/png;base64,{base64.b64encode(f.read()).decode()}"


使用 Base64 调用


image_b64 = image_to_base64("local_image.png")

result = edit_image(

api_key="your-api-key",

feature="repaint",

image_url=image_b64,

prompt="新的描述",

mask_url=image_to_base64("local_mask.png")

)

输出限制与注意事项

限制项 说明
提示词长度 ≤ 220 字符（中英文）
图片格式 PNG / JPG / JPEG / WEBP / BMP / ICO
图片大小 ≤ 10MB
长宽比 ≤ 4:1
最小尺寸 单边 ≥ 128px（建议 > 512px）
图片有效期 返回的 URL 有效期 24 小时
并发限制 高频调用易超时，建议控制并发
批量生成 单次最多 n=4 张（qwen-image-edit 仅支持 n=1）

ERNIE-iRAG-Edit vs 社区替代方案

特性 ERNIE-iRAG-Edit API FLUX Kontext ComfyUI Inpainting
接入方式 API 调用 开源模型 本地 ComfyUI
价格 ¥0.14/张 自有 GPU 自有 GPU
消除功能 ✅ erase ✅ ✅
重绘功能 ✅ repaint ✅ ✅
变体生成 ✅ variation ❌ 需额外配置
中文支持 ✅ 优秀 ⚠️ 一般 依赖模型
部署难度 零部署 需 GPU 环境 需 ComfyUI 配置
适合场景 快速集成、无 GPU 深度定制 高级用户工作流

ERNIE-iRAG-Edit API 最大的优势是零部署成本和中文编辑能力。如果你的需求是快速将图像编辑功能集成到应用中，或者需要处理中文 prompt 的编辑任务，API 方案是最直接的选择。

与 ERNIE-Image 的关系

需要明确的是，ERNIE-iRAG-Edit 是百度千帆平台上的独立图像编辑模型，与开源的 ERNIE-Image 8B DiT 模型是不同的产品线。但两者同属 ERNIE 生态，技术路线一脉相承。

社区期待的开源 ERNIE-Image 编辑模型仍在开发中。当开源编辑模型发布后，开发者将拥有更多选择：API 方案用于快速集成，开源方案用于深度定制。

定价分析

操作类型 价格 适用场景
erase ¥0.14/张 消除不需要的元素
repaint ¥0.14/张 局部修改、风格调整
variation ¥0.14/张 场景变体、风格化版本

对于批量编辑场景，假设每天处理 100 张图片：

  • 日均成本：¥14（约 $2）
  • 月均成本：¥420（约 $60）

相比自建 GPU 编辑服务（每月 GPU 成本通常在 ¥1000+），API 方案在中小规模场景下具有明显的成本优势。

数据来源：百度千帆开发者文档、qianfan.cloud.baidu.com、百度智能云官方公告

ERNIE-Image Team