Image-2 图片生成

Image-2 使用 OpenAI 兼容的图片生成接口，支持文本生成图片。不同模型和通道对尺寸、质量及返回格式的支持可能不同。

接口

POST https://api.topapis.cn/v1/images/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

模型

常见通道标识包括：

模型	用途
gpt-image-2	常规图片生成
gpt-image-4K	高分辨率图片生成

这些名称是调用示例，不代表所有 API Key 都已授权。请求前应查询 /v1/models。

请求参数

参数	类型	必填	说明
model	string	是	当前账号可见的图片模型标识
prompt	string	是	图片内容、风格、构图和限制描述
size	string	建议	宽x高，例如 1024x1024 或 2048x1152
quality	string	否	常用值为 low、medium、high 或 auto
n	integer	否	生成数量；不确定通道限制时使用 1

请求尺寸是目标值。下载图片后应读取真实宽高，不要只依赖请求参数。

普通生图

curl "https://api.topapis.cn/v1/images/generations" \
  -H "Authorization: Bearer $TOPAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "清晨湖边的现代木屋，写实建筑摄影，自然光",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

高分辨率生图

curl "https://api.topapis.cn/v1/images/generations" \
  -H "Authorization: Bearer $TOPAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-4K",
    "prompt": "雨后的城市滨江夜景，写实摄影，丰富建筑细节",
    "size": "3840x2160",
    "quality": "high",
    "n": 1
  }'

只有当 /v1/models 返回对应高分辨率模型时才发送此请求。

返回格式

接口可能返回临时 URL：

{
  "created": 1783785600,
  "data": [
    { "url": "https://example.com/generated-image.png" }
  ]
}

也可能返回 Base64：

{
  "created": 1783785600,
  "data": [
    { "b64_json": "BASE64_IMAGE_DATA" }
  ]
}

客户端应同时兼容 url 和 b64_json。临时 URL 可能过期，收到响应后应立即下载到自己的存储。

超时与失败

• 图片生成请求可设置到 300 秒，下载使用独立超时。
• 401 和 403 先检查鉴权与模型权限，不自动重试。
• 429、502 和 503 使用最多 3 次的指数退避。
• 响应成功后仍应验证文件类型、文件大小和真实像素尺寸。