跳到主要内容

GPT-Image-1 图像编辑

GPT-Image-1 支持对现有图像进行编辑和修改，可以实现局部修改、风格转换等功能。

接口地址​

POST https://api.weelinking.com/v1/images/edits

请求参数​

参数类型必填说明
modelstring是固定为 gpt-image-1
imagefile是原始图像文件（PNG 格式）
promptstring是编辑指令描述
maskfile否遮罩图像，指定编辑区域
ninteger否生成数量，默认 1
sizestring否输出尺寸

使用示例​

Python​

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.weelinking.com/v1"
)

response = client.images.edit(
    model="gpt-image-1",
    image=open("original.png", "rb"),
    mask=open("mask.png", "rb"),
    prompt="在空白区域添加一只小猫",
    n=1,
    size="1024x1024"
)

print(response.data[0].url)

cURL​

curl https://api.weelinking.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F model="gpt-image-1" \
  -F image="@original.png" \
  -F mask="@mask.png" \
  -F prompt="在空白区域添加一只小猫" \
  -F n=1 \
  -F size="1024x1024"

遮罩图像说明​

遮罩图像用于指定要编辑的区域：

  • 透明区域：将被编辑/替换
  • 不透明区域：保持原样

创建遮罩​

from PIL import Image

# 创建遮罩图像
mask = Image.new("RGBA", (1024, 1024), (0, 0, 0, 255))

# 将要编辑的区域设为透明
pixels = mask.load()
for x in range(412, 612):
    for y in range(412, 612):
        pixels[x, y] = (0, 0, 0, 0)

mask.save("mask.png")

编辑场景​

添加元素​

prompt: "在桌子上添加一杯咖啡"

替换元素​

prompt: "将红色汽车替换为蓝色汽车"

移除元素​

prompt: "移除背景中的人物，用自然背景填充"

定价​

尺寸价格
1024x1024$0.04/张
1536x1024$0.08/张

注意事项​

  1. 图像必须是 PNG 格式
  2. 遮罩图像尺寸必须与原图相同
  3. 提示词应清晰描述期望的编辑结果