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

OpenAI 官方 gpt-image-2 模型，基于 /v1/images/generations 兼容协议
异步处理模式，返回 task_id 用于后续查询
文生图 / 图生图 / 局部重绘（mask）三合一
新增 resolution 档位字段，支持 1K / 2K / 4K 分辨率选择
支持 15 种比例，1K / 2K / 4K 档均可用
单次最多生成 4 张图片，参考图最多 16 张
与 gpt-image-1.5-official 接口 95% 对齐，迁移只需改模型名

curl --request POST \
  --url https://xcompute.us/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2-official",
    "prompt": "星空下的古老城堡",
    "size": "16:9",
    "resolution": "2k",
    "quality": "high",
    "n": 1
  }'

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

Authorizations

Authorization

string

required

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

Authorization: Bearer YOUR_API_KEY

Body

model

string

default:"gpt-image-2-official"

required

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

prompt

string

required

图像生成的文本描述

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

size

string

default:"1:1"

画面比例对外使用比例值，系统内部按 resolution 自动映射到具体像素。支持以下比例，也可传入 auto 由服务端自动选择合适比例：

auto - 自动（由服务端根据 prompt / 参考图自动选择比例）
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 - 竖构图
3:1 - 横构图（超宽 Banner）
1:3 - 竖构图（超长海报）
21:9 - 横构图（电影超宽屏）
9:21 - 竖构图

也支持直接传入像素尺寸，例如 1881x836 / 887x1774。

resolution

string

default:"1k"

分辨率档位（新增字段）控制实际出图清晰度。

1k - 1024 基准，省钱日常够用（默认）
2k - 2048 基准，适合海报 / 高清需求
4k - 3840 基准，支持下方映射表中的 15 个比例

4K 支持下方映射表中的 15 个比例；也可以直接通过 size 传入表格中的像素尺寸。

quality

string

default:"auto"

图片质量

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

background

string

default:"auto"

背景模式

auto - 自动（默认）
opaque - 不透明
transparent - ⚠️ gpt-image-2-official 不支持透明背景，传了会被系统静默降级为 auto

moderation

string

default:"auto"

审核强度

auto - 默认审核强度
low - 更宽松的审核强度

output_format

string

default:"png"

输出格式

png - 默认
jpeg - 文件更小
webp - 现代浏览器最优

output_compression

integer

输出压缩强度，范围 0-100

仅对 jpeg / webp 有效

integer

default:"1"

生成图片张数取值范围：1 ~ 4

必须输入纯数字（如 1），不要加引号

image_urls

array

参考图 URL 数组

Show 详细说明

最多 16 张 参考图，超过会被拒绝
须是公网可直接访问的稳定图片 URL

mask_url

string

遮罩图 URL，用于局部重绘（inpainting）

需搭配 image_urls 一起使用

1、上传遮罩图前，请先确认图片 Alpha 通道为「是」。2、遮罩图尺寸需与首张参考图一致。

尺寸 × 分辨率映射表

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

size	`1k`	`2k`	`4k`
`1:1`	1024×1024	2048×2048	2880×2880
`3:2`	1536×1024	2048×1360	3520×2336
`2:3`	1024×1536	1360×2048	2336×3520
`4:3`	1024×768	2048×1536	3312×2480
`3:4`	768×1024	1536×2048	2480×3312
`5:4`	1280×1024	2560×2048	3216×2576
`4:5`	1024×1280	2048×2560	2576×3216
`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
`3:1`	1881×836 / 1536×512	3072×1024	3840×1280
`1:3`	887×1774 / 512×1536	1024×3072	1280×3840
`21:9`	2016×864	2688×1152	3840×1648
`9:21`	864×2016	1152×2688	1648×3840

说明：部分尺寸会按 16 倍数和像素上限做近似映射，例如 3:2 / 2:3 @ 2K 实际是 2048×1360，21:9 @ 4K 是 3840×1648；请以表格中的实际像素为准。

使用场景示例

文生图（最简请求）

{
  "model": "gpt-image-2-official",
  "prompt": "星空下的古老城堡"
}

2K 高清海报

{
  "model": "gpt-image-2-official",
  "prompt": "赛博朋克夜景",
  "size": "16:9",
  "resolution": "2k",
  "quality": "high",
  "output_format": "jpeg",
  "output_compression": 90
}

4K 壁纸

{
  "model": "gpt-image-2-official",
  "prompt": "雪山日出全景",
  "size": "16:9",
  "resolution": "4k",
  "quality": "high",
  "n": 1
}

图生图（多参考图融合）

{
  "model": "gpt-image-2-official",
  "prompt": "将两张参考图融合成一张插画海报，保留主体轮廓",
  "size": "1:1",
  "quality": "high",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ]
}

局部重绘（mask）

{
  "model": "gpt-image-2-official",
  "prompt": "把背景换成沙漠日落",
  "size": "1:1",
  "quality": "medium",
  "image_urls": ["https://your-cdn.com/photo.png"],
  "mask_url": "https://your-cdn.com/mask.png"
}

多张生成（n > 1）

{
  "model": "gpt-image-2-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1:1",
  "quality": "low",
  "n": 4
}

直接传像素串（高级用法）

{
  "model": "gpt-image-2-official",
  "prompt": "wide cinematic shot",
  "size": "3840x2160",
  "quality": "high"
}

Response

code

integer

响应状态码

data

array

返回数据数组

Show 属性

status

string

任务状态

submitted - 已提交

task_id

string

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

查询任务结果

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

成功响应示例

{
  "code": 200,
  "data": {
    "id": "task_01KPTXXXXXXXXXXXXXXX",
    "status": "completed",
    "progress": 100,
    "actual_time": 46,
    "cost": 0.05279,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/xxxxxxxx-gpt_image_2_official_task_xxx_0.png"
          ],
          "expires_at": 1776928569
        }
      ]
    }
  }
}

任务状态流转：submitted → in_progress → completed / failed。取图方式：data.result.images[0].url[0]。

轮询建议

首次查询延迟：提交后等待 10~20 秒再开始查询
查询间隔：建议 3~5 秒一次
超时参考：high + 2k/4k 组合耗时可达 130 秒，客户端超时建议 ≥ 180 秒
批量查询：若需同时查询多个任务，请使用 POST /v1/tasks/batch

账户接口

音频接口

图像接口

任务接口

文本接口

上传接口

视频接口

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

Authorizations

Body

尺寸 × 分辨率映射表

使用场景示例

Response

查询任务结果

成功响应示例

轮询建议

账户接口

音频接口

图像接口

任务接口

文本接口

上传接口

视频接口

Documentation Index

​Authorizations

​Body

​尺寸 × 分辨率映射表

​使用场景示例

​Response

​查询任务结果

​成功响应示例

​轮询建议

Authorizations

Body

尺寸 × 分辨率映射表

使用场景示例

Response

查询任务结果

成功响应示例

轮询建议