跳转到主要内容
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.getinfinityblue.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2",
  "prompt": "一只可爱的海獭宝宝漂浮在蓝色海面上",
  "size": "1024x1024"
}
'
{
  "created": 123,
  "data": [
    {
      "b64_json": "<string>",
      "url": "<string>"
    }
  ],
  "usage": {
    "total_tokens": 123,
    "input_tokens": 123,
    "output_tokens": 123,
    "input_tokens_details": {
      "text_tokens": 123,
      "image_tokens": 123
    }
  }
}

​
可使用的模型

模型 ID说明
gpt-image-2GPT Image 2，支持灵活尺寸与多种输出格式
快照版本（如 gpt-image-2-2026-04-21）暂不可用，请使用 gpt-image-2。

​
尺寸说明（gpt-image-2）

size 参数默认为 auto，支持灵活尺寸：
  • 边长不超过 3840px
  • 宽高均为 16 的倍数
  • 长边与短边比例不超过 3:1
  • 总像素介于 655,360 到 8,294,400 之间
常用预设：1024x1024、1536x1024（横向）、1024x1536（纵向）、 2048x2048、2048x1152、3840x2160、2160x3840。 也支持自定义尺寸（如 1024x768），只要宽高均为 16 的倍数且符合上述约束即可。

​
流式输出

本站暂不支持流式输出。stream 和 partial_images 参数会被接受但不生效， 响应始终以完整 JSON 一次性返回。

​
质量与格式

  • quality：本站暂不支持 quality 分档，统一使用 auto 级别输出。 参数会被接受但各级别间无实际差异。
  • output_format：png（默认）/ jpeg / webp
  • output_compression：仅对 jpeg / webp 生效，取值 0–100

授权

​
Authorization
string
header
必填

使用 Bearer Token 认证，格式：Authorization: Bearer sk-xxxxxx。 在 控制台 获取 API Key。

请求体

application/json

图像生成请求体。

​
model
string
必填

用于图像生成的模型 ID，传入 gpt-image-2。 快照版本（如 gpt-image-2-2026-04-21）暂不可用。

示例:

"gpt-image-2"

​
prompt
string
必填

所需图像的文本描述。对于 gpt-image-2，最长支持 32,000 个字符。

示例:

"一只可爱的海獭宝宝漂浮在蓝色海面上"

​
n
integer
默认值:1

本站暂不支持 n 参数，默认 n=1，每次请求输出 1 张图片。 如需多张图片，请循环调用接口。

必填范围: 1 <= x <= 1
​
size
string
默认值:auto

生成图像的尺寸。对于 gpt-image-2，默认为 auto，支持灵活尺寸（边长不超过 3840px、宽高均为 16 的倍数、长宽比不超过 3:1、总像素在 655,360–8,294,400 之间）； 常用预设包括 1024x1024、1536x1024、1024x1536、2048x2048、 2048x1152、3840x2160、2160x3840。

示例:

"1024x1024"

"1536x1024"

"auto"

​
background
enum<string>

生成图像的背景设置。对于 gpt-image-2，默认为 auto， 可选 opaque（不透明）或 auto。 gpt-image-2 不支持 transparent（透明背景），传入该值会返回 400 错误。

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

内容审核级别。对于 gpt-image-2，默认为 auto（标准）， 可选 low（宽松）。

可用选项:
auto,
low
​
quality
enum<string>

本站暂不支持 quality 分档，统一使用 auto 级别输出。 参数会被接受但各级别间无实际差异。

可用选项:
low,
medium,
high,
auto
​
stream
boolean
默认值:false

本站暂不支持流式输出。参数会被接受但不生效， 响应始终以完整 JSON 一次性返回。

​
style
string

图像风格参数，仅 DALL·E 3 支持。 gpt-image-2 下参数会被接受但无实际效果。

​
output_format
enum<string>

生成图像的输出格式。对于 gpt-image-2，默认为 png， 可选 png、jpeg、webp。仅 GPT Image 系列支持此参数。

可用选项:
png,
jpeg,
webp
​
output_compression
integer

输出图像的压缩质量（0–100）。对于 gpt-image-2， 仅在 output_format 为 jpeg 或 webp 时生效。

必填范围: 0 <= x <= 100
​
partial_images
integer
默认值:0

流式返回时的中间帧数量（0–3）。依赖流式输出功能， 由于本站暂不支持流式输出，此参数当前不可用。

必填范围: 0 <= x <= 3
​
response_format
enum<string>
默认值:b64_json

返回图像的格式。默认为 b64_json，返回 Base64 编码的图像数据； 设为 url 时返回图像的临时访问 URL（建议尽快下载或转存）。

可用选项:
b64_json,
url
​
user
string

代表终端用户的唯一标识符，可用于监控和滥用检测。

响应

成功生成图像

图像生成响应体。

​
created
integer

创建时间的 Unix 时间戳（秒）。

示例:

1713833628

​
data
object[]

生成的图像列表。

​
usage
object

本次请求的 token 用量统计。