图片编辑 API

图片编辑接口在原图基础上按提示词修改(换背景、改元素、风格化等), GPT-Image 与 Gemini 图像系列均可使用。

接口

POST https://api.4allapi.com/v1/images/edits

multipart/form-data 格式,主要字段:

字段	说明
model	图像模型名,如 gpt-image-2、gemini-3.1-flash-image
image	原图文件(可多张,image[])
prompt	编辑指令

示例

curl https://api.4allapi.com/v1/images/edits \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -F model="gpt-image-2" \
  -F image="@product.png" \
  -F prompt="把背景换成温馨的圣诞客厅场景,保持商品主体不变"

resp = client.images.edit(
    model="gpt-image-2",
    image=open("product.png", "rb"),
    prompt="把背景换成海边日落场景",
)
print(resp.data[0].url or resp.data[0].b64_json[:50])

使用要点

• 多图输入(如商品图 + 参考风格图)按顺序传多个 image 字段,提示词里说明各图角色;
• 编辑同样按次计费,画幅/分辨率仍由模型名后缀控制;
• 想保持人物/商品一致性,提示词明确”保持主体不变”,并优先用原图分辨率相近的输出档;
• 超时与重试策略同图片调用须知。