Images Edits

POST https://wrouter.ai/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://wrouter.ai/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://wrouter.ai/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://wrouter.ai/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 時，整張圖都會被作為參考重繪（取決於模型）