GPT Image 2

在图片生成或编辑端点中使用模型 ID gpt-image-2。发送请求前请选择 Direct 资源组。

GPT Image 2 在 data[].b64_json 中返回 Base64 图片数据。请勿传入仅适用于 DALL·E 的 response_format 参数。请切换到所需能力的 Tab 查看请求与响应。

生成图片
透明背景输出
编辑图片
蒙版编辑

生成图片

POST /v1/images/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "一张钴蓝色玻璃瓶放在浅色石材上的产品照片，清晨柔光",
    "size": "1024x1024",
    "quality": "low",
    "output_format": "png",
    "moderation": "auto",
    "n": 1
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

请求体

string

必填

模型 ID，必须为 gpt-image-2。

string

必填

要生成图片的描述。长度：1–32,000 个字符。

integer

默认值:1

生成图片数量。支持范围：1–10。

string

默认值:"auto"

auto 或自定义 WIDTHxHEIGHT。宽和高必须能被 16 整除，宽高比在 1:3 到 3:1 之间，任一边不超过 3,840 像素，总像素数在 655,360 到 8,294,400 之间。高于 2560x1440 的分辨率属于实验性能力。

string

渲染质量：low、medium 或 high。

string

默认值:"auto"

背景模式：auto、opaque 或 transparent。透明输出为预览功能，要求使用 PNG 或 WebP。

string

默认值:"png"

输出格式：png、jpeg 或 webp。

integer

默认值:100

JPEG 或 WebP 压缩级别，范围为 0–100。PNG 输出会忽略此参数。

string

默认值:"auto"

内容审核强度：auto 或 low。

生成响应

200

{
  "created": 1789052391,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAA..."
    }
  ],
  "model": "gpt-image-2",
  "usage": {
    "input_tokens": 24,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 24
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 220
  }
}

integer

创建时间，Unix 秒级时间戳。

object[]

生成图片结果。

string

Base64 编码的图片数据。

string

生成响应的模型。

object

本次请求的 token 用量。

integer

文本与图片输入 token 总数。

object

按文本和图片拆分的输入 token。

integer

图片输入 token 数。

integer

文本输入 token 数。

integer

输出 token 总数。

object

按文本和图片拆分的输出 token。

integer

图片输出 token 数。

integer

文本输出 token 数。

integer

输入和输出 token 总数。

透明背景输出

POST /v1/images/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "一个简洁的绿色圆形应用图标，独立置于完全透明画布上，不要阴影",
    "size": "1024x1024",
    "quality": "low",
    "background": "transparent",
    "output_format": "png",
    "n": 1
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

请求体

string

必填

模型 ID，必须为 gpt-image-2。

string

必填

要生成图片的描述。长度：1–32,000 个字符。

integer

默认值:1

生成图片数量。支持范围：1–10。

string

默认值:"auto"

string

渲染质量：low、medium 或 high。

string

默认值:"auto"

使用此能力时必须设为 transparent。GPT Image 2 的透明背景输出为预览功能。

string

默认值:"png"

透明背景必须使用 png 或 webp，默认 png。JPEG 不支持透明背景。

integer

默认值:100

JPEG 或 WebP 压缩级别，范围为 0–100。PNG 输出会忽略此参数。

string

默认值:"auto"

内容审核强度：auto 或 low。

透明背景响应

200

{
  "created": 1789052391,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAA..."
    }
  ],
  "model": "gpt-image-2",
  "usage": {
    "input_tokens": 24,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 24
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 220
  }
}

integer

创建时间，Unix 秒级时间戳。

object[]

生成图片结果。

string

Base64 编码的图片数据。

string

生成响应的模型。

object

本次请求的 token 用量。

integer

文本与图片输入 token 总数。

object

按文本和图片拆分的输入 token。

integer

图片输入 token 数。

integer

文本输入 token 数。

integer

输出 token 总数。

object

按文本和图片拆分的输出 token。

integer

图片输出 token 数。

integer

文本输出 token 数。

integer

输入和输出 token 总数。

编辑图片

POST /v1/images/edits

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/images/edits \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'model=gpt-image-2' \
  --form 'image[]=@/path/to/product.png' \
  --form 'image[]=@/path/to/reference.png' \
  --form 'prompt=保持产品不变，并应用参考图片中的光线和配色' \
  --form 'size=1536x1024' \
  --form 'output_format=png' \
  --form 'n=1'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"multipart/form-data"

必填

使用 cURL 等支持 multipart 的客户端时会自动设置。

请求体

必须提供 image 或 image[] 其中一种图片输入。

string

必填

模型 ID，必须为 gpt-image-2。

file

一张 PNG 或 JPEG 源图片，必须小于 50 MB。上传多张图片时改用 image[]。

file[]

最多 16 张 PNG 或 JPEG 源图片，每张小于 50 MB。不要同时传入 image 和 image[]。

string

必填

图片编辑指令。长度：1–32,000 个字符。

integer

默认值:1

返回的编辑图片数量。支持范围：1–10。

string

默认值:"auto"

string

默认值:"png"

输出格式：png、jpeg 或 webp。

integer

默认值:100

JPEG 或 WebP 压缩级别，范围为 0–100。PNG 输出会忽略此参数。

编辑响应

200

{
  "created": 1789052450,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAA..."
    }
  ]
}

integer

创建时间，Unix 秒级时间戳。

object[]

编辑图片结果。

string

Base64 编码的图片数据。

GPT Image 2 始终以高保真模式处理编辑输入。请省略 input_fidelity；该模型不允许修改此参数。

蒙版编辑

POST /v1/images/edits

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/images/edits \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'model=gpt-image-2' \
  --form 'image=@/path/to/source.png' \
  --form 'mask=@/path/to/mask.png' \
  --form 'prompt=保持产品不变，仅将蒙版区域内的背景替换为暖色摄影棚渐变' \
  --form 'size=1536x1024' \
  --form 'output_format=png' \
  --form 'n=1'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"multipart/form-data"

必填

使用 cURL 等支持 multipart 的客户端时会自动设置。

请求体

必须提供 image 或 image[] 其中一种图片输入。蒙版用于引导编辑区域，不保证像素级精确边界。

string

必填

模型 ID，必须为 gpt-image-2。

file

一张 PNG 或 JPEG 源图片，必须小于 50 MB。上传多张图片时改用 image[]。

file[]

最多 16 张 PNG 或 JPEG 源图片，每张小于 50 MB。不要同时传入 image 和 image[]。

file

必填

蒙版编辑能力必须提供；在通用编辑接口中为可选参数。蒙版必须包含 Alpha 通道，与第一张源图片的格式和尺寸一致，并小于 50 MB。透明区域用于引导编辑。上传多张源图片时，蒙版作用于第一张图片。

string

必填

图片编辑指令。长度：1–32,000 个字符。

integer

默认值:1

返回的编辑图片数量。支持范围：1–10。

string

默认值:"auto"

string

默认值:"png"

输出格式：png、jpeg 或 webp。

integer

默认值:100

JPEG 或 WebP 压缩级别，范围为 0–100。PNG 输出会忽略此参数。

蒙版编辑响应

200

{
  "created": 1789052450,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAA..."
    }
  ]
}

integer

创建时间，Unix 秒级时间戳。

object[]

编辑图片结果。

string

Base64 编码的图片数据。

GPT Image 2 始终以高保真模式处理编辑输入。请省略 input_fidelity；该模型不允许修改此参数。

校验规则

background: "transparent" 要求 output_format: "png" 或 output_format: "webp"。
自定义尺寸必须满足上方的整除、宽高比、边长和总像素限制。
output_compression 仅适用于 JPEG 和 WebP 输出。
GPT Image 2 返回 Base64 图片数据，不支持通过 response_format 返回 URL。

上游协议请参阅 OpenAI GPT Image 2 模型页面, 创建图片接口, 以及创建图片编辑接口。

概览

原生兼容端点

模型 API

生成图片

请求头

请求体

生成响应

透明背景输出

请求头

请求体

透明背景响应

编辑图片

请求头

请求体

编辑响应

蒙版编辑

请求头

请求体

蒙版编辑响应

校验规则

​生成图片

​请求头

​请求体

​生成响应

​透明背景输出

​请求头

​请求体

​透明背景响应

​编辑图片

​请求头

​请求体

​编辑响应

​蒙版编辑

​请求头

​请求体

​蒙版编辑响应

​校验规则

生成图片

请求头

请求体

生成响应

透明背景输出

请求头

请求体

透明背景响应

编辑图片

请求头

请求体

编辑响应

蒙版编辑

请求头

请求体

蒙版编辑响应

校验规则