Skip to main content
POST
OpenAI image generations
用于根据文本提示生成图片。

GPT Image 2

  • 使用 GPT Image 2 时请显式传入 model: "gpt-image-2";未传 model 时,ApiGo 默认使用 dall-e-2
  • gpt-image-2 支持文生图、灵活尺寸和 lowmediumhighauto 四档质量
  • 未传 sizequality 时,ApiGo 分别使用 1024x1024medium;如需让模型自动选择,显式传入 auto
  • 自定义尺寸的两条边必须是 16 的倍数,长短边比例不超过 3:1,单边不超过 3840 px,总像素数为 655,360–8,294,400
  • background 可传 opaqueautogpt-image-2 当前不支持 transparent
  • 图片通过 data[].b64_json 返回。解码后按 output_format 保存,默认格式为 png
jpegwebp 可配合 output_compression(0–100)控制压缩率。moderation 支持 autolow 复杂提示词可能需要接近两分钟处理,请为客户端配置足够的请求超时时间。 如需基于原图修改、局部重绘或多图融合,请使用 /v1/images/edits

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
prompt
string
必填

描述目标图片的文本提示词。

示例:

"一只可爱的小猫在花园里玩耍,阳光明媚,油画风格"

model
enum<string>
默认值:dall-e-2

图片生成模型;未传时 ApiGo 使用 dall-e-2。

可用选项:
gpt-image-2,
gpt-image-1,
dall-e-3,
dall-e-2
background
enum<string>

GPT Image 模型支持。gpt-image-2 仅支持 opaque 和 auto,不支持 transparent。

可用选项:
transparent,
opaque,
auto
moderation
enum<string>

GPT Image 模型支持 auto 和 low。

可用选项:
auto,
low
n
integer
默认值:1

生成图片的数量;dall-e-3 仅支持 1。

必填范围: 1 <= x <= 10
output_compression
integer
默认值:100

GPT Image 模型生成 JPEG/WebP 时的压缩率。

必填范围: 0 <= x <= 100
output_format
enum<string>

GPT Image 模型支持 png、jpeg 和 webp。

可用选项:
png,
jpeg,
webp
quality
enum<string>

不同模型支持的值不同。GPT Image 未传时,ApiGo 使用 medium。

可用选项:
auto,
high,
medium,
low,
hd,
standard
response_format
enum<string>

仅适用于 dall-e-2 和 dall-e-3。

可用选项:
url,
b64_json
size
string

允许值取决于模型。gpt-image-2 支持 auto 或符合尺寸约束的自定义分辨率;未传时 ApiGo 使用 1024x1024。

示例:

"1024x1024"

style
enum<string>

仅 dall-e-3 支持。

可用选项:
vivid,
natural
user
string

终端用户的唯一标识。

响应

Successful image generation response

created
integer<int64>
必填

Unix 时间戳,单位为秒。

data
object[]
必填
background
enum<string>
可用选项:
transparent,
opaque,
auto
output_format
enum<string>
可用选项:
png,
jpeg,
webp
quality
enum<string>
可用选项:
auto,
high,
medium,
low,
hd,
standard
size
string
usage
object