Skip to main content
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://code.heihuzi.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格",
    "n": 1,
    "size": "2048x1152",
    "quality": "high",
    "output_format": "png"
  }'

{
  "created": 1710000000,
  "data": [
    {
      "b64_json": "..."
    }
  ]
}
/v1/images/generations 用于 GPT Image 2 文生图。该接口仅面向 OpenAI-compatible 分组，并受图片生成权限控制。 
curl --request POST \
  --url https://code.heihuzi.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格",
    "n": 1,
    "size": "2048x1152",
    "quality": "high",
    "output_format": "png"
  }'

​
Body

​
model
string
required
图像生成模型。推荐固定使用 gpt-image-2。
​
prompt
string
required
图像生成提示词。
​
n
integer
生成图片张数，默认 1。
​
size
string
输出尺寸。支持 auto 或具体像素尺寸，例如 1024x1024、2048x1152、3840x2160。
​
quality
string
图片质量参数，例如 low、medium、high。
​
response_format
string
旧 OpenAI Images 客户端兼容字段。GPT Image 2 转发到官方 OpenAI 上游时，服务端会移除该字段；不要依赖它强制指定 url 或 b64_json。
​
output_format
string
输出图片格式，例如 png、jpeg、webp。
​
output_compression
integer
输出压缩比例，适用于 jpeg、jpg、webp，范围 0 到 100。
​
stream
boolean
是否启用流式返回。开启后返回 OpenAI-compatible SSE 事件。

​
Response

{
  "created": 1710000000,
  "data": [
    {
      "b64_json": "..."
    }
  ]
}

​
错误

状态码场景说明
400参数不合法模型、尺寸、格式或请求体不符合要求。
401未认证缺少或错误的 Bearer Token。
403无图片权限API Key 所属分组没有图片生成能力。
429并发或速率限制降低请求频率后重试。
500/503上游失败上游账号、渠道或网关临时不可用。

​
注意事项

  • 该接口是同步 OpenAI Images 兼容响应，不返回异步任务 ID。
  • 非流式响应通常包含 data 数组；每个结果可能包含 url 或 b64_json，具体取决于上游能力和渠道配置。
  • 对 GPT Image 2 不支持的字段，服务端会按兼容策略处理。
  • 非 OpenAI-compatible 分组不能调用 Images 接口。