API 参考

false

false

model必填

string

/v1/models 返回的可用模型 ID，例如 gpt-image-2.5 或 gpt-image-2。

约束

minLength

1

maxLength

128

prompt必填

string

约束

minLength

1

maxLength

32000

size可选

string

请求尺寸为 auto 或 WIDTHxHEIGHT。宽高须为不超过 3840 的正整数，宽高比介于 1:3 和 3:1，总像素介于 655360 和 8294400。省略时使用模型默认值。

约束

minLength

1

maxLength

32

pattern

"^(auto|[1-9][0-9]{0,3}x[1-9][0-9]{0,3})$"

quality可选

string

所选模型支持的质量，省略时使用模型默认值。

约束

minLength

1

maxLength

16

n可选

integer

生成图片的张数，受所选模型上限限制。gpt-image-2.5 和 gpt-image-2 每次支持 1–4 张，默认 1 张。

约束

minimum

1

maximum

10

output_format可选

string

enum["png","jpeg","webp"]

default"png"

background可选

string

透明背景输出须使用 PNG 或 WebP。

enum["auto","opaque","transparent"]

moderation可选

string

enum["auto","low"]

output_compression可选

integer

JPEG 和 WebP 的输出压缩参数，PNG 接收此参数但不应用。

约束

minimum

0

maximum

100

response_format可选

string

同步响应的交付格式。异步任务通过详情中的公共图片 URL 交付。

enum["b64_json","url"]

default"b64_json"

stream可选

boolean

设为 false 或省略，需要后台生成时使用异步接口。

constfalse

user可选

string

调用方的终端用户标识，随任务保存。

约束

maxLength

256

从 image 和 images 中选择一个字段，两者均支持单张参考图或数组。

image可选

ImageReferences

images可选

ImageReferences

{
  "not": {
    "required": [
      "image",
      "images"
    ]
  }
}

model必填

string

/v1/models 返回的可用模型 ID，例如 gpt-image-2.5 或 gpt-image-2。

约束

minLength

1

maxLength

128

prompt必填

string

约束

minLength

1

maxLength

32000

size可选

string

请求尺寸为 auto 或 WIDTHxHEIGHT。宽高须为不超过 3840 的正整数，宽高比介于 1:3 和 3:1，总像素介于 655360 和 8294400。省略时使用模型默认值。

约束

minLength

1

maxLength

32

pattern

"^(auto|[1-9][0-9]{0,3}x[1-9][0-9]{0,3})$"

quality可选

string

所选模型支持的质量，省略时使用模型默认值。

约束

minLength

1

maxLength

16

n可选

integer

生成图片的张数，受所选模型上限限制。gpt-image-2.5 和 gpt-image-2 每次支持 1–4 张，默认 1 张。

约束

minimum

1

maximum

10

output_format可选

string

enum["png","jpeg","webp"]

default"png"

background可选

string

透明背景输出须使用 PNG 或 WebP。

enum["auto","opaque","transparent"]

moderation可选

string

enum["auto","low"]

output_compression可选

integer

JPEG 和 WebP 的输出压缩参数，PNG 接收此参数但不应用。

约束

minimum

0

maximum

100

response_format可选

string

同步响应的交付格式。异步任务通过详情中的公共图片 URL 交付。

enum["b64_json","url"]

default"b64_json"

stream可选

boolean

设为 false 或省略，需要后台生成时使用异步接口。

constfalse

user可选

string

调用方的终端用户标识，随任务保存。

约束

maxLength

256

image可选

stringbinary

PNG、JPEG 或 WebP 文件，多张图片使用重复的 image[] 字段。

image[]可选

array

约束

minItems

1

maxItems

16

数组元素

stringbinary

model必填

string

/v1/models 返回的可用模型 ID，例如 gpt-image-2.5 或 gpt-image-2。

约束

minLength

1

maxLength

128

prompt必填

string

约束

minLength

1

maxLength

32000

size可选

string

请求尺寸为 auto 或 WIDTHxHEIGHT。宽高须为不超过 3840 的正整数，宽高比介于 1:3 和 3:1，总像素介于 655360 和 8294400。省略时使用模型默认值。

约束

minLength

1

maxLength

32

pattern

"^(auto|[1-9][0-9]{0,3}x[1-9][0-9]{0,3})$"

quality可选

string

所选模型支持的质量，省略时使用模型默认值。

约束

minLength

1

maxLength

16

n可选

integer

生成图片的张数，受所选模型上限限制。gpt-image-2.5 和 gpt-image-2 每次支持 1–4 张，默认 1 张。

约束

minimum

1

maximum

10

output_format可选

string

enum["png","jpeg","webp"]

default"png"

background可选

string

透明背景输出须使用 PNG 或 WebP。

enum["auto","opaque","transparent"]

moderation可选

string

enum["auto","low"]

output_compression可选

integer

JPEG 和 WebP 的输出压缩参数，PNG 接收此参数但不应用。

约束

minimum

0

maximum

100

response_format可选

string

同步响应的交付格式。异步任务通过详情中的公共图片 URL 交付。

enum["b64_json","url"]

default"b64_json"

stream可选

boolean

设为 false 或省略，需要后台生成时使用异步接口。

constfalse

user可选

string

调用方的终端用户标识，随任务保存。

约束

maxLength

256

从 image 和 images 中选择一个字段，两者均支持单张参考图或数组。

image可选

ImageReferences

images可选

ImageReferences

{
  "not": {
    "required": [
      "image",
      "images"
    ]
  }
}

model必填

string

/v1/models 返回的可用模型 ID，例如 gpt-image-2.5 或 gpt-image-2。

约束

minLength

1

maxLength

128

prompt必填

string

约束

minLength

1

maxLength

32000

size可选

string

请求尺寸为 auto 或 WIDTHxHEIGHT。宽高须为不超过 3840 的正整数，宽高比介于 1:3 和 3:1，总像素介于 655360 和 8294400。省略时使用模型默认值。

约束

minLength

1

maxLength

32

pattern

"^(auto|[1-9][0-9]{0,3}x[1-9][0-9]{0,3})$"

quality可选

string

所选模型支持的质量，省略时使用模型默认值。

约束

minLength

1

maxLength

16

n可选

integer

生成图片的张数，受所选模型上限限制。gpt-image-2.5 和 gpt-image-2 每次支持 1–4 张，默认 1 张。

约束

minimum

1

maximum

10

output_format可选

string

enum["png","jpeg","webp"]

default"png"

background可选

string

透明背景输出须使用 PNG 或 WebP。

enum["auto","opaque","transparent"]

moderation可选

string

enum["auto","low"]

output_compression可选

integer

JPEG 和 WebP 的输出压缩参数，PNG 接收此参数但不应用。

约束

minimum

0

maximum

100

response_format可选

string

同步响应的交付格式。异步任务通过详情中的公共图片 URL 交付。

enum["b64_json","url"]

default"b64_json"

stream可选

boolean

设为 false 或省略，需要后台生成时使用异步接口。

constfalse

user可选

string

调用方的终端用户标识，随任务保存。

约束

maxLength

256

image可选

stringbinary

PNG、JPEG 或 WebP 文件，多张图片使用重复的 image[] 字段。

image[]可选

array

约束

minItems

1

maxItems

16

数组元素

stringbinary

model必填

string

/v1/models 返回的可用模型 ID，例如 gpt-image-2.5 或 gpt-image-2。

约束

minLength

1

maxLength

128

prompt必填

string

约束

minLength

1

maxLength

32000

size可选

string

请求尺寸为 auto 或 WIDTHxHEIGHT。宽高须为不超过 3840 的正整数，宽高比介于 1:3 和 3:1，总像素介于 655360 和 8294400。省略时使用模型默认值。

约束

minLength

1

maxLength

32

pattern

"^(auto|[1-9][0-9]{0,3}x[1-9][0-9]{0,3})$"

quality可选

string

所选模型支持的质量，省略时使用模型默认值。

约束

minLength

1

maxLength

16

n可选

integer

生成图片的张数，受所选模型上限限制。gpt-image-2.5 和 gpt-image-2 每次支持 1–4 张，默认 1 张。

约束

minimum

1

maximum

10

output_format可选

string

enum["png","jpeg","webp"]

default"png"

background可选

string

透明背景输出须使用 PNG 或 WebP。

enum["auto","opaque","transparent"]

moderation可选

string

enum["auto","low"]

output_compression可选

integer

JPEG 和 WebP 的输出压缩参数，PNG 接收此参数但不应用。

约束

minimum

0

maximum

100

response_format可选

string

同步响应的交付格式。异步任务通过详情中的公共图片 URL 交付。

enum["b64_json","url"]

default"b64_json"

stream可选

boolean

设为 false 或省略，需要后台生成时使用异步接口。

constfalse

user可选

string

调用方的终端用户标识，随任务保存。

约束

maxLength

256

从 image 和 images 中选择一个字段，两者均支持单张参考图或数组。

image可选

ImageReferences

images可选

ImageReferences

{
  "not": {
    "required": [
      "image",
      "images"
    ]
  }
}

mask可选

ImageMask

model必填

string

/v1/models 返回的可用模型 ID，例如 gpt-image-2.5 或 gpt-image-2。

约束

minLength

1

maxLength

128

prompt必填

string

约束

minLength

1

maxLength

32000

size可选

string

请求尺寸为 auto 或 WIDTHxHEIGHT。宽高须为不超过 3840 的正整数，宽高比介于 1:3 和 3:1，总像素介于 655360 和 8294400。省略时使用模型默认值。

约束

minLength

1

maxLength

32

pattern

"^(auto|[1-9][0-9]{0,3}x[1-9][0-9]{0,3})$"

quality可选

string

所选模型支持的质量，省略时使用模型默认值。

约束

minLength

1

maxLength

16

n可选

integer

生成图片的张数，受所选模型上限限制。gpt-image-2.5 和 gpt-image-2 每次支持 1–4 张，默认 1 张。

约束

minimum

1

maximum

10

output_format可选

string

enum["png","jpeg","webp"]

default"png"

background可选

string

透明背景输出须使用 PNG 或 WebP。

enum["auto","opaque","transparent"]

moderation可选

string

enum["auto","low"]

output_compression可选

integer

JPEG 和 WebP 的输出压缩参数，PNG 接收此参数但不应用。

约束

minimum

0

maximum

100

response_format可选

string

同步响应的交付格式。异步任务通过详情中的公共图片 URL 交付。

enum["b64_json","url"]

default"b64_json"

stream可选

boolean

设为 false 或省略，需要后台生成时使用异步接口。

constfalse

user可选

string

调用方的终端用户标识，随任务保存。

约束

maxLength

256

image可选

stringbinary

PNG、JPEG 或 WebP 文件，多张图片使用重复的 image[] 字段。

image[]可选

array

约束

minItems

1

maxItems

16

数组元素

stringbinary

mask可选

stringbinary

带 alpha 通道的 PNG 蒙版，尺寸须与第一张参考图一致。透明区域指定编辑位置，蒙版不占用参考图数量名额。