Images Edits

POST https://api.wrouter.io/v1/images/edits

支持两种请求形态，按 model 自动路由：

• OpenAI 形态（multipart/form-data）— 适用于 dall-e-2、gpt-image-1
• 百炼 / Qwen 形态（application/json）— 适用于 qwen-image-edit；这是 newapi 网关原生文档化的格式

形态 A：OpenAI 形态（multipart/form-data）

字段	类型	必填	说明
model	string	✓	dall-e-2、gpt-image-1
image	file	✓	原图，PNG（含 alpha 通道），<= 4MB
mask	file		蒙版图，透明区域为待重绘区域
prompt	string	✓	描述目标效果
n	integer		生成数量
size	string		1024x1024 等
response_format	string		"url" 或 "b64_json"

curl https://api.wrouter.io/v1/images/edits \
  -H "Authorization: Bearer $WROUTER_API_KEY" \
  -F model=gpt-image-1 \
  -F image=@./original.png \
  -F mask=@./mask.png \
  -F prompt="把背景换成星空" \
  -F size=1024x1024

from openai import OpenAI
client = OpenAI(api_key="sk-...", base_url="https://api.wrouter.io/v1")
with open("original.png","rb") as img, open("mask.png","rb") as mask:
    out = client.images.edit(
        model="gpt-image-1",
        image=img,
        mask=mask,
        prompt="替换背景为热带海滩",
        size="1024x1024",
    )
print(out.data[0].url)

形态 B：百炼 / Qwen 形态（application/json）

参数	类型	必填	说明
model	string	✓	qwen-image-edit 系列
input	object	✓	包含 prompt、image（URL 或 base64）、mask（可选）
parameters	object		包含 size、n 等

curl https://api.wrouter.io/v1/images/edits \
  -H "Authorization: Bearer $WROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-edit",
    "input": {
      "prompt": "把背景换成星空",
      "image": "https://example.com/original.png"
    },
    "parameters": {"size": "1024*1024"}
  }'

蒙版规则（OpenAI 形态）

• 蒙版图必须与原图同尺寸
• 透明像素 标记为需要重绘的区域
• 不透明像素 保持原样
• 没有提供 mask 时，整张图都会被作为参考重绘（取决于模型）