GPT-Image-2 图片接口

GPT-Image-2 图片生成与编辑接口文档。

图片生成

接口地址

POST https://www.moyu.info/v1/images/generations

请求示例

cURL

其他语言

请求参数

参数	类型	必填	默认值	说明
model	string	是	-	模型名称，固定为 `gpt-image-2`
prompt	string	是	-	期望生成图像的文本描述
n	number	否	1	生成的图像数量，取值范围 `1~10`
size	string	否	auto	图片尺寸：`1024x1024`、`1536x1024`、`1024x1536`、`auto`
quality	string	否	auto	图片质量：`high`、`medium`、`low`、`auto`（auto 自动选择最佳质量）

响应格式

{
  "background": "opaque",
  "created": 1776998971,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ],
  "output_format": "png",
  "quality": "medium",
  "size": "1536x1024",
  "usage": {
    "prompt_tokens": 61,
    "completion_tokens": 229,
    "total_tokens": 290
  }
}

图片编辑

接口地址

POST https://www.moyu.info/v1/images/edits

图片上传方式

图片编辑接口必须使用 multipart/form-data 格式提交，不支持 JSON。

图片通过 image 字段以本地文件上传的方式传入（即 @文件路径），不支持传 URL 或 Base64。

方式	是否支持	说明
本地文件上传	支持	`-F "image=@/path/to/image.png"`
图片 URL	不支持	不能直接传 `https://...` 链接
Base64 字符串	不支持	不能传 Base64 编码内容

支持的图片格式：png、jpg、webp、gif

请求示例

cURL

单图编辑（@ 符号表示上传本地文件）：

多图编辑（最多 16 张）：

其他语言

请求参数

参数	类型	必填	默认值	说明
model	string	是	-	模型名称，固定为 `gpt-image-2`
prompt	string	是	-	期望编辑图像的文本描述
image	file	否	-	上传单张图片文件，使用 `-F "image=@/path/to/file.png"`
image[]	file	否	-	上传多张图片文件，最多 16 张，使用 `image[]=@file1.png` 形式传入
n	number	否	1	生成的图像数量，取值范围 `1~10`
size	string	否	auto	图片尺寸：`1024x1024`、`1536x1024`、`1024x1536`、`auto`
quality	string	否	auto	图片质量：`high`、`medium`、`low`、`auto`

实测结果

已使用平台接口完成一次真实编辑测试，调用方式为 multipart/form-data 上传图片文件：

接口：POST /v1/images/edits

模型：gpt-image-2

上传方式：-F "image=@/tmp/test_red.png"

prompt：将红色方块变成蓝色，背景改为白色

返回结果：成功，HTTP 200

总耗时：约 171.34 秒

输出格式：png

输出尺寸：1024x1024

返回内容：data[0].b64_json

token 用量：prompt_tokens=88、completion_tokens=196、total_tokens=284

响应格式

{
  "background": "opaque",
  "created": 1780036809,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ],
  "output_format": "png",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "prompt_tokens": 88,
    "completion_tokens": 196,
    "total_tokens": 284
  }
}

响应字段说明

字段	类型	说明
background	string	背景模式：`opaque`（不透明）或 `transparent`（透明）
created	integer	创建时间戳
data	array	生成/编辑的图片列表
data[].b64_json	string	Base64 编码的图片数据
output_format	string	输出格式：`png`、`jpg`、`webp`
quality	string	实际使用的质量等级
size	string	输出图片尺寸
usage.prompt_tokens	integer	输入 token 数
usage.completion_tokens	integer	输出 token 数
usage.total_tokens	integer	总 token 数（用于计费）

注意事项

图片编辑接口使用 multipart/form-data 格式上传，不支持 JSON body

生成时间较长（通常 60~180 秒），请确保客户端超时设置足够（建议 300 秒以上）

返回结果为 Base64 编码图片，需解码后保存为文件

如 CDN 回源超时时间过短可能导致 504 错误，建议配置 CDN 超时 ≥ 300 秒

图片生成#

接口地址#

请求示例#

cURL#

其他语言#

请求参数#

响应格式#

图片编辑#

接口地址#

图片上传方式#

请求示例#

cURL#

其他语言#

请求参数#

实测结果#

响应格式#

响应字段说明#

注意事项#

图片生成

接口地址

请求示例

cURL

其他语言

请求参数

响应格式

图片编辑

接口地址

图片上传方式

请求示例

cURL

其他语言

请求参数

实测结果

响应格式

响应字段说明

注意事项