POST
使用参考图和提示词编辑图片。上传本地文件时使用 multipart;使用公开图片 URL 时发送 JSON 请求。

请求参数

string
required
具备图片编辑能力的模型,例如已开放的 gpt-image-2。
string
required
编辑提示词,说明需要保留的内容和需要修改的部分。
file
multipart 的本地图片文件。与 JSON 的 images 二选一。
array<object>
JSON 请求使用 [{"image_url":"https://..."}]。图片必须可由服务端访问;多图数量和用途受模型限制。
file | object
编辑遮罩,适用于支持局部编辑的模型。遮罩尺寸和透明区域要求见对应模型说明。
integer
default:"1"
生成数量,使用正整数,建议先用 1。
string
目标输出尺寸,不要求与参考图像素尺寸完全相同,但需符合模型支持范围。
string
url 或 b64_json。
string
输入图片保真度,适用于支持该参数的模型;省略时使用模型默认值。

常见错误

  • multipart 请求不要手动设置 Content-Type: application/json,交给客户端生成文件边界。
  • reference.png 必须真实存在;URL 示例必须替换,不能把本地磁盘路径作为公网 URL。
  • 上传失败时检查文件格式、大小和图片 URL 的可访问性。
  • 编辑结果从 data[].url 或 data[].b64_json 读取,分别对应下载地址和 Base64 图片数据。
Grok 图片模型的 JSON 图片字段有所不同,见Grok Image。