编辑图像（gpt-image-1.5）

POST https://www.vortapapi.com/v1/images/edits

根据输入图片与文本提示词，对图片进行局部或整体编辑，并返回一张或多张生成后的图片结果。

该接口兼容 OpenAI 风格的图像编辑 API，适用于基于现有图片进行修改、替换背景、调整元素、添加/移除对象等场景。

请求头

名称	必填	说明
Authorization	是	使用 Bearer Token 进行认证，例如：Bearer sk-***
Content-Type	是	multipart/form-data

请求参数

请求体需使用 multipart/form-data。

参数	类型	必填	说明
model	string	是	使用的图像模型，例如 gpt-image-1.5
image	file 或 file[]	是	需要编辑的原始图片。可上传一张或多张图片，具体支持情况取决于模型能力
prompt	string	是	描述希望如何编辑图片的文本指令
mask	file	否	蒙版图片。透明区域表示需要被编辑的部分，非透明区域通常会尽量保留
n	integer	否	生成图片数量，默认通常为 1
size	string	否	输出图片尺寸，例如 1024x1024、1024x1536、1536x1024 或 auto
quality	string	否	图片质量，例如 auto、low、medium、high
response_format	string	否	返回格式。常见值为 b64_json
user	string	否	终端用户标识，可用于审计、风控或统计

请求示例

curl https://www.vortapapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-***" \
  -F "model=gpt-image-1.5" \
  -F "image=@input.png" \
  -F "prompt=将图片中的背景替换为傍晚的海边，并保持人物姿势和服装不变" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -F "n=1"

使用蒙版编辑

如果只希望修改图片中的指定区域，可以上传 mask。蒙版中的透明区域会被视为需要重绘或编辑的区域。

curl https://www.vortapapi.com/v1/images/edits \
  -H "Authorization: Bearer sk-***" \
  -F "model=gpt-image-1.5" \
  -F "image=@room.png" \
  -F "mask=@mask.png" \
  -F "prompt=在透明区域添加一张现代风格的蓝色沙发，光照与房间保持一致" \
  -F "size=1024x1024"

响应示例

{
  "created": 1713833628,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

响应字段

字段	类型	说明
created	integer	响应创建时间，Unix 时间戳
data	array	生成结果列表
data[].b64_json	string	Base64 编码的图片数据。当使用 b64_json 返回格式时提供

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-***",
    base_url="https://www.vortapapi.com/v1"
)

result = client.images.edit(
    model="gpt-image-1.5",
    image=open("input.png", "rb"),
    prompt="把背景改成雪山场景，保持主体人物不变",
    size="1024x1024",
    quality="high"
)

image_base64 = result.data[0].b64_json
print(image_base64)

JavaScript 示例

import OpenAI from "openai";
import fs from "fs";

const client = new OpenAI({
  apiKey: "sk-***",
  baseURL: "https://www.vortapapi.com/v1"
});

const result = await client.images.edit({
  model: "gpt-image-1.5",
  image: fs.createReadStream("input.png"),
  prompt: "将照片改成电影海报风格，保留人物面部特征",
  size: "1024x1024",
  quality: "high"
});

console.log(result.data[0].b64_json);

注意事项

• 图像编辑接口应使用 multipart/form-data 上传文件。
• 如果提供 mask，请确保蒙版与原图尺寸匹配，以获得更稳定的编辑效果。
• 提示词应明确说明需要修改的区域、目标风格以及需要保留的内容。
• 返回的 b64_json 可解码为图片文件后保存或展示。