GPT Image
图片生成查看型号目录 →
异步生成或编辑 GPT 图片,按型号选择分辨率与质量。
本系列支持的端点
- gpt-image-2(异步)
POST https://zexapi.com/v1/videos
POST
https://zexapi.com/v1/videos鉴权 Authorization: Bearer YOUR_API_KEY
使用 API Key 进行 Bearer 鉴权。JSON 请求设置 Content-Type: application/json;Multipart 请求由客户端自动生成 boundary。
尺寸、质量与参考图字段均放在请求体顶层。
gpt-image-2 接口文档(/v1/videos 视频接口格式)
接口地址
POST /v1/videos功能说明
/v1/videos 接口调用 GPT 图片生成能力(与视频生成共用接口,通过 model 参数区分),支持文生图和图生图两种模式,采用异步请求方式,先提交返回任务 ID,再轮询获取结果。1.
aspect_ratio 传入固定比例字符串(如 9:16、16:9 等),精确控制输出比例2.
size 传入像素尺寸字符串(如 "1280x720"、"1456x624")——与 aspect_ratio 二选一,不需要同时传3.
"auto",或两个参数均不传——两者等价,均根据提示词内容自动推断,无固定比例;提示词中若写明了比例(如"竖屏 9:16"),模型也会据此生成gpt-image-2 为 1K,gpt-image-2-2K 为 2K,gpt-image-2-4K 为 4K,gpt-image-2.5 为 1K(不要传 2K / 4K)。换分辨率要换 modelgpt-image-2.5-flare / sunburst 及其 -vip。同一模型出 1K / 2K / 4K,用 size 像素,或 aspect_ratio + image_size / resolution-vip 固定 medium,可不传 quality。-vip 可传 low / medium / high,不传则自动判断。见下文「质量」。支持的模型
| model 参数 | 分辨率 | 质量 | 说明 |
|---|---|---|---|
gpt-image-2 | 1K | 固定 medium | 分辨率固定 1K |
gpt-image-2-2K | 2K | 固定 medium | 分辨率固定 2K |
gpt-image-2-4K | 4K | 固定 medium | 分辨率固定 4K |
gpt-image-2.5 | 仅 1K | 固定 medium | 分辨率固定 1K,不要传 2K / 4K |
gpt-image-2.5-flare | 1K / 2K / 4K | 固定 medium | 用参数选分辨率 |
gpt-image-2.5-sunburst | 1K / 2K / 4K | 固定 medium | 调用方式与 gpt-image-2.5-flare 相同 |
gpt-image-2.5-flare-vip | 1K / 2K / 4K | low / medium / high | 调用方式与 gpt-image-2.5-flare 相同;不传 quality 则自动判断 |
gpt-image-2.5-sunburst-vip | 1K / 2K / 4K | low / medium / high | 调用方式与 gpt-image-2.5-flare-vip 相同 |
/v1/videos 异步流程,仅 model、分辨率控档方式与质量不同;计费与渠道路由以 model 区分。请求头
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称,见上表。大小写须与上表一致(2K/4K 为大写 K;gpt-image-2.5 中间是点号) |
| prompt | string | 是 | 文本提示词 |
| aspect_ratio | string | 否 | 宽高比。传固定比例字符串(见下表)则精确控制;传 "auto" 或不传则根据提示词自动推断。与 size 二选一 |
| size | string | 否 | 像素尺寸,格式 "宽x高"(如 "1280x720"、"1456x624"、"3696x1584")。按对照表选 1K / 2K / 4K 列即可直接出对应分辨率。与 aspect_ratio 二选一 |
| image_size | string | 否 | 分辨率档位:1K、2K、4K(大写 K)。与 resolution 完全等价,只传其中一个。配合 aspect_ratio 使用;gpt-image-2.5 仅允许 1K(可不传,默认 1K) |
| resolution | string | 否 | 与 image_size 通用、等价,取值同样是 1K / 2K / 4K。不要与 image_size 同时传不同值 |
| quality | string | 否 | 仅 -vip 模型:low、medium、high。不传则自动判断。其余 模型质量已固定为 medium,可不传 |
| images | string[] | 否 | 参考图片数组(支持 Base64 或 URL),最多 8 张。传此参数为图生图模式,不传或传空数组为文生图模式 |
aspect_ratio 支持的值
| 值 | 方向 | 适用场景 |
|---|---|---|
auto | 自动 | 不指定比例,根据提示词内容自动推断(与不传等价) |
1:1 | 正方形 | 通用、社交媒体 |
16:9 | 横向(宽屏) | 横屏内容、PC 端 |
9:16 | 竖向 | 短视频、手机竖屏 |
4:3 | 横向 | 传统屏幕 |
3:4 | 竖向 | 竖屏内容 |
3:2 | 横向 | 摄影常用 |
2:3 | 竖向 | 竖版海报 |
5:4 | 横向 | 大幅横图 |
4:5 | 竖向 | Instagram 竖图 |
21:9 | 超宽横向 | 影院宽幅 |
比例与 size 对照
gpt-image-2 用 1K 列,gpt-image-2-2K 用 2K 列,gpt-image-2-4K 用 4K 列,gpt-image-2.5 只用 1K 列。可用参数选档的模型:三列都可用,见下方「分辨率控制」。
| 比例 | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 3:2 | 1248x832 | 2496x1664 | 3504x2336 |
| 2:3 | 832x1248 | 1664x2496 | 2336x3504 |
| 4:3 | 1152x864 | 2304x1728 | 3264x2448 |
| 3:4 | 864x1152 | 1728x2304 | 2448x3264 |
| 5:4 | 1120x896 | 2240x1792 | 3200x2560 |
| 4:5 | 896x1120 | 1792x2240 | 2560x3200 |
| 21:9 | 1456x624 | 3024x1296 | 3696x1584 |
分辨率控制
image_size 与 resolution 是通用字段,语义完全相同,取值均为 1K / 2K / 4K(大写 K),只传其中一个。下面两种选档方式只用于可用参数选档的模型。gpt-image-2、gpt-image-2-2K、gpt-image-2-4K、gpt-image-2.5 分辨率固定,不靠这两个字段换档。| 模型 | 可用档位 | 说明 |
|---|---|---|
gpt-image-2 | 1K | 分辨率固定 |
gpt-image-2-2K | 2K | 分辨率固定 |
gpt-image-2-4K | 4K | 分辨率固定 |
gpt-image-2.5 | 仅 1K | 分辨率固定;不要传 2K / 4K;size 只取上表 1K 列 |
gpt-image-2.5-flare、gpt-image-2.5-sunburst 及其 -vip | 1K / 2K / 4K | 用参数选档;不要改成带 -2K / -4K 后缀的模型名 |
size 直接传目标像素(与 aspect_ratio 二选一)"宽x高",像素本身就决定了 1K / 2K / 4K,不必再传 image_size / resolution。例如 "size": "1456x624" 为 21:9 的 1K,2K 用 "3024x1296",4K 用 "3696x1584"。分辨率固定为 1K 的 gpt-image-2、gpt-image-2.5 只能传 1K 列;gpt-image-2-2K 用 2K 列,gpt-image-2-4K 用 4K 列。可用参数选档的模型三列都可传。aspect_ratio + image_size 或 resolutionaspect_ratio 传固定比例(如 "21:9");档位用 image_size 或 resolution(二者等价)。例如 "aspect_ratio": "21:9" + "image_size": "4K" 即为 21:9 的 4K。gpt-image-2.5 档位只能是 1K 或不传。gpt-image-2、gpt-image-2-2K、gpt-image-2-4K 的分辨率看模型名,不要靠 image_size / resolution 换档。宽高比 / 分辨率控制方式对比
方式 用法 效果 像素尺寸 "size": "1456x624"或"size": "3696x1584"直接按像素出 1K / 2K / 4K,与 aspect_ratio二选一比例 + 档位 "aspect_ratio": "21:9"+"image_size"/"resolution"比例与分辨率分开传;两字段通用等价 固定比例 "aspect_ratio": "9:16"精确输出指定比例。分辨率固定的模型看 model;可用参数选档的模型可再加image_size/resolution自动推断 "aspect_ratio": "auto"或两者均不传根据提示词内容自动决定,无固定比例 提示词描述 不传或传 "auto",prompt 中写明比例模型从提示词中读取比例并遵循
质量 quality
-vip 模型质量固定为 medium,可不传 quality。-vip 模型在顶层传 quality:| 值 | 说明 |
|---|---|
low | 低质量 |
medium | 中等质量 |
high | 高质量 |
| 不传 | 自动判断 |
gpt-image-2.5-flare-vip、gpt-image-2.5-sunburst-vip。调用方式相同,只换 model。images 数组元素传法
| 方式 | 示例 |
|---|---|
| 图片 URL | "https://example.com/reference.jpg" |
| Base64 | "data:image/jpeg;base64,/9j/4AAQSkZJRg..." |
注意:传入图片 URL 时,网关会自动将其下载并转为 Base64 后发给上游,请确保 URL 为可公网访问的图片直链。
请求示例
文生图 — 固定比例
{
"model": "gpt-image-2",
"prompt": "生成抖音带货风格主图,主体 xxx",
"aspect_ratio": "9:16"
}gpt-image-2.5同用法,分辨率固定 1K。要固定 2K / 4K,把model改成gpt-image-2-2K/gpt-image-2-4K。不传或"auto"则按提示词自动推断比例。
文生图 — size 像素(flare / sunburst 选 1K / 2K / 4K)
{
"model": "gpt-image-2.5-flare",
"prompt": "做个广告",
"size": "1456x624"
}对照表 1K 列即 1K;2K 用 "3024x1296",4K 用"3696x1584"。gpt-image-2.5只能用 1K 列。gpt-image-2.5-sunburst把model换掉即可。
文生图 — 比例 + 分辨率(flare / sunburst)
{
"model": "gpt-image-2.5-flare",
"prompt": "做个广告",
"aspect_ratio": "21:9",
"image_size": "4K"
}image_size与resolution等价,只传一个。gpt-image-2.5-sunburst把model换掉即可。-vip在此基础上再加quality,见下例。
文生图 — vip 指定质量
quality取值low/medium/high;不传则自动判断。gpt-image-2.5-flare-vip、gpt-image-2.5-sunburst-vip把model换掉即可。非-vip质量固定 medium,可不传quality。
图生图
{
"model": "gpt-image-2.5-flare",
"prompt": "做个广告",
"aspect_ratio": "21:9",
"image_size": "4K",
"images": [
"https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png"
]
}images也可传 Base64(data:image/jpeg;base64,...)。不传或空数组为文生图。
响应参数
/v1/videos,object 固定为 "video"。完成态图片地址位于顶层 url 和 image_url,两者值相同。| 参数名 | 类型 | 说明 |
|---|---|---|
| id | string | 任务 ID,格式:task_xxxx |
| object | string | 固定值:video(图片任务也是,类型看 model) |
| model | string | 使用的模型名称 |
| status | string | 任务状态:queued(排队中)、in_progress |