curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2_official",
    "params": {
      "prompt": "星空下的古老城堡",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "quality": "high"
    },
    "out_task_id": "my_task_123456"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KPTXXXXXXXXXXXXXXX"
    }
  ]
}

GPT-Image-2

GPT-Image-2 官方渠道图像生成

OpenAI 官方 gpt-image-2 模型，基于 /v1/images/generations 兼容协议
异步处理模式，返回 task_id 用于后续查询
文生图 / 图生图三合一
新增 resolution 档位字段，支持 1K / 2K / 4K 分辨率选择
支持 13 种比例（4K 档支持其中 6 个：16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21）
参考图最多 9 张，支持 URL 与 base64 混填
提交的 prompt 会经过平台敏感词 / 安全审核，违规内容会被直接拒绝

POST

api

openapi

submit

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2_official",
    "params": {
      "prompt": "星空下的古老城堡",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "quality": "high"
    },
    "out_task_id": "my_task_123456"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KPTXXXXXXXXXXXXXXX"
    }
  ]
}

Authorizations

Authorization

string

必填

所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面获取您的 API Key使用时在请求头中添加：

Authorization: Bearer YOUR_API_KEY

Body

model

string

默认值:"gpt_image_2_official"

必填

图像生成模型名称固定填写 gpt_image_2_official（OpenAI 官方 gpt-image-2 模型）

params

object

必填

模型参数对象

显示 params 对象属性

prompt

string

必填

图像生成的文本描述

支持中英文，建议详细描述
提交前会经过平台敏感词 / 安全审核，命中违规内容会直接返回错误

aspect_ratio

string

默认值:"1:1"

画面比例对外使用比例值，系统内部按 resolution 自动映射到具体像素。支持 13 种比例：

1:1 - 正方形构图（默认，社交头像 / Logo）
3:2 - 横构图（单反相机常见比例）
2:3 - 竖构图（海报竖版）
4:3 - 横构图（经典显示器 / PPT）
3:4 - 竖构图
5:4 - 横构图
4:5 - 竖构图（Instagram 竖版帖子）
16:9 - 横构图（宽屏视频封面）
9:16 - 竖构图（手机全屏 / 短视频封面）
2:1 - 横构图（网页 Banner）
1:2 - 竖构图
21:9 - 横构图（电影超宽屏）
9:21 - 竖构图

只支持比例写法，传像素尺寸（如 1024x1024）会直接报错

resolution

string

默认值:"1K"

分辨率档位控制实际出图清晰度：

1K - 1024 基准，省钱日常够用（默认）
2K - 2048 基准，适合海报 / 高清需求
4K - 3840 基准，仅 6 个比例支持（16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21）

不支持的 4K 组合会返回 400：

1:1 × 4K ❌（超像素上限）
3:2 / 2:3 × 4K ❌（超像素上限）
4:3 / 3:4 × 4K ❌（超像素上限）
5:4 / 4:5 × 4K ❌（超像素上限）

想高清上述比例时，改用 resolution=2K。

quality

string

默认值:"low"

图片质量

low - 快速省钱，轮廓够用（默认）
medium - 平衡
high - 最高精度（4K + high 耗时 >120s）

image_url

array

参考图数组，传入后走图生图模式

最多 9 张 参考图
支持以下两种格式：
1. 公开可访问的 URL
2. Base64 编码格式
  - 必须使用完整的 Data URI 格式：data:image/{格式};base64,{base64数据}
  - 支持的图片格式：jpeg、png、webp
  - 示例：data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  - ⚠️ 注意：必须包含 data:image/jpeg;base64, 前缀部分

out_task_id

string

必填

发起方任务ID用户自定义的任务标识，必填

尺寸 × 分辨率映射表

aspect_ratio × resolution → OpenAI 实际像素（13 比例 × 3 档位）：

aspect_ratio	`1K`	`2K`	`4K`
`1:1`	1024×1024	2048×2048	❌ 超像素上限
`3:2`	1536×1024	2048×1360	❌ 超像素上限
`2:3`	1024×1536	1360×2048	❌ 超像素上限
`4:3`	1024×768	2048×1536	❌ 超像素上限
`3:4`	768×1024	1536×2048	❌ 超像素上限
`5:4`	1280×1024	2560×2048	❌ 超像素上限
`4:5`	1024×1280	2048×2560	❌ 超像素上限
`16:9`	1536×864	2048×1152	3840×2160
`9:16`	864×1536	1152×2048	2160×3840
`2:1`	2048×1024	2688×1344	3840×1920
`1:2`	1024×2048	1344×2688	1920×3840
`21:9`	2016×864	2688×1152	3840×1648
`9:21`	864×2016	1152×2688	1648×3840

3:2 / 2:3 @ 2K 实际是 2048×1360（近似比例，误差 < 0.5%）；4K 仅支持 6 个比例（总像素超 OpenAI 上限的组合不可用）。

Response

code

integer

响应状态码

data

array

返回数据数组

显示属性

status

string

任务状态

submitted - 已提交

task_id

string

任务唯一标识符，用于后续查询任务结果

查询任务结果

提交成功后返回 task_id，通过 GET /v1/tasks/{task_id} 轮询任务状态，详见任务查询接口。

轮询建议

首次查询延迟：提交后等待 10~20 秒再开始查询
查询间隔：建议 3~5 秒一次
超时参考：high + 2K/4K 组合耗时可达 130 秒，客户端超时建议 ≥ 180 秒

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2_official",
    "params": {
      "prompt": "星空下的古老城堡",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "quality": "high"
    },
    "out_task_id": "my_task_123456"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KPTXXXXXXXXXXXXXXX"
    }
  ]
}

GPT-Image-2 图片生成 Seedream V4 图片生成

Documentation Index

​Authorizations

​Body

​尺寸 × 分辨率映射表

​Response

​查询任务结果

​轮询建议

Authorizations

Body

尺寸 × 分辨率映射表

Response

查询任务结果

轮询建议