OpenAI 生成图片

/v1/images/generations 是 OpenAI Images API 兼容的同步生图接口。HTTP 请求会在图片结果就绪后返回。

接口说明

项目	值
Method	POST
Path	/v1/images/generations
Content-Type	application/json
认证	Authorization: Bearer YOUR_API_KEY
平台要求	需要 OpenAI 平台分组且分组启用生图能力。

请求参数

参数	类型	必填	说明
model	string	否	OpenAI Images 兼容模型，未传时默认 gpt-image-2。
prompt	string	是	生图提示词。
size	string	否	输出尺寸，例如 1024x1024。
n	integer	否	生成图片数量，默认 1，必须大于 0。
response_format	string	否	响应格式，常用 b64_json。
stream	boolean	否	是否流式返回，取决于所选模型能力。
quality	string	否	OpenAI Images API 参数，是否生效取决于所选模型。
background	string	否	OpenAI Images API 参数，是否生效取决于所选模型。
output_format	string	否	OpenAI Images API 参数，是否生效取决于所选模型。
output_compression	integer	否	OpenAI Images API 参数，是否生效取决于所选模型。
moderation	string	否	OpenAI Images API 参数，是否生效取决于所选模型。
style	string	否	OpenAI Images API 参数，是否生效取决于所选模型。

请求示例

curl https://api.llmapi.site/v1/images/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a product photo of a ceramic coffee cup on a white table",
    "size": "1024x1024",
    "n": 1,
    "response_format": "b64_json"
  }'

响应 — 200 OK

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

字段	说明
created	响应创建时间，Unix 时间戳。
data[].b64_json	当 response_format 为 b64_json 时返回的图片 Base64。
data[].url	当 URL 响应可用时返回的图片地址。

错误码

状态码	原因
400	请求体无效、模型不是图片模型，或缺少必要参数。
401	API Key 缺失或无效。
403	余额、额度或分组权限校验失败。
404	当前 API Key 分组不能调用 OpenAI Images API。
429	达到频率限制或并发限制。
500 / 502 / 503	网关或上游服务商失败。

适用边界

• 本接口只适用于 OpenAI Images API 兼容请求。