图片生成

API 参考/Images/图片生成

创建图片

POST/v1/images/generations

通过 OpenAI 兼容 Images API 创建图片，支持 GPT Image 系列模型。

认证

通过 Bearer Token 认证。

Authorizationstring必填

API Key，格式为 Bearer YOUR_API_KEY。

默认值：-

Content-Typestring必填

请求体格式。

默认值：application/json

Request-Idstring可选

客户侧生成的唯一请求标识，用于追踪和排查。

默认值：-

请求

请求体必须包含 model 和 prompt。

modelstring必填

图片模型 ID，例如 gpt-image-2 或 gpt-image-1。

默认值：-

promptstring必填

图片描述文本。

默认值：-

ninteger可选

生成图片数量，通常取 1 到 10。

默认值：1

sizestring可选

图片尺寸，例如 1024x1024、1536x1024、1024x1536 或 auto。

默认值：1024x1024

qualitystring可选

图片质量：low、medium、high 或 auto。

默认值：auto

backgroundstring可选

背景设置：transparent、opaque 或 auto。具体支持取决于模型。

默认值：auto

output_formatstring可选

输出格式：png、jpeg 或 webp。

默认值：png

userstring可选

终端用户唯一标识。

默认值：-

响应

默认返回 Base64 图片数据。业务侧需要自行解码并保存或上传到对象存储。

createdinteger必填

创建时间，Unix 时间戳。

默认值：-

dataarray必填

生成的图片列表。

默认值：-

data[].b64_jsonstring可选

Base64 编码后的图片数据。

默认值：-

data[].urlstring可选

图片 URL。部分模型或配置可能返回。

默认值：-

错误

状态码	说明
400	请求体字段错误、图片尺寸不支持或提示词不符合安全策略
401	API Key 缺失或无效
403	当前账户无权调用该模型
429	请求超过速率限制
500 / 503	平台或上游模型服务异常

相关指南

• GPT Image 2
• 多模态 / 图像生成
• 模型与能力

请求示例POST

curl __DOCS_API_ORIGIN__/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只在雪山上奔跑的狼，写实风格",
    "n": 1,
    "size": "1024x1024",
    "quality": "high"
  }'

成功响应200

{
  "created": 1764044000,
  "data": [
    {
      "b64_json": "/9j/4AAQSkZJRgABAQ..."
    }
  ]
}