图片生成&编辑（gpt-image-2，异步）
开发中
正式环境
https://poloai.top
正式环境
https://poloai.top
POST
https://poloai.top
最后修改时间：2026-07-24 02:31:24
功能说明
/v1/videos 接口调用 GPT 图片生成能力（与视频生成共用接口，通过 model 参数区分），支持文生图和图生图两种模式，采用异步任务方式，先提交返回任务 ID，再轮询获取结果。画幅 / 宽高比
1.
aspect_ratio 传入固定比例字符串（如 9:16、16:9 等），精确控制输出比例2.
aspect_ratio 传 "auto"，或不传该参数 —— 两者等价，均根据提示词内容自动推断，无固定比例；提示词中若写明了比例（如“竖屏 9:16”），模型也会据此生成支持的模型
| model 参数 | 说明 |
|---|---|
gpt-image-2 | GPT 图片生成（标准档） |
gpt-image-2-2K | 2K 分辨率 |
gpt-image-2-4K | 4K 分辨率 |
/v1/videos 异步流程，仅 model 不同；下游计费与上游路由以 model 区分档位。请求头
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称，取值为 gpt-image-2、gpt-image-2-2K、gpt-image-2-4K 之一（大小写须与上表一致，其中 2K / 4K 为大写 K） |
| prompt | string | 是 | 文本提示词 |
| aspect_ratio | string | 否 | 宽高比。传固定比例字符串（见下表支持的 10 种值）则精确控制；传 "auto" 或不传则根据提示词内容自动推断，没有固定比例 |
| images | string[] | 否 | 参考图片数组（支持 Base64 或 URL），最多 5 张。传此参数为图生图模式，不传或传空数组为文生图模式 |
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 | 超宽横向 | 影院宽幅 |
宽高比控制方式对比
| 方式 | 用法 | 效果 |
|---|---|---|
| 固定比例 | "aspect_ratio": "9:16" | 精确输出指定比例 |
| 自动推断 | "aspect_ratio": "auto" 或不传 | 根据提示词内容自动决定，无固定比例 |
| 提示词描述 | 不传或传 "auto"，prompt 中写明比例 | 模型从提示词中读取比例并遵循 |
images 数组元素传法
| 方式 | 示例 |
|---|---|
| 图片 URL | "https://example.com/reference.jpg" |
| Base64 | "data:image/jpeg;base64,/9j/4AAQSkZJRg..." |
注意：传入图片 URL 时，网关会自动将其下载并转为 Base64 后发给上游，请确保 URL 为可公网访问的图片直链。
请求示例
文生图 — 固定宽高比（竖屏 9:16）
{
"model": "gpt-image-2",
"prompt": "生成抖音带货风格主图，主体 xxx",
"aspect_ratio": "9:16"
}文生图 — 自动推断宽高比（传 auto）
{
"model": "gpt-image-2",
"prompt": "一只可爱的柴犬坐在草地上",
"aspect_ratio": "auto"
}传 "auto"与不传aspect_ratio完全等价，由官方根据内容自动决定比例，无固定值。
文生图 — 自动推断宽高比（不传参数）
{
"model": "gpt-image-2",
"prompt": "一只可爱的柴犬坐在草地上"
}文生图 — 提示词描述比例（配合自动推断）
{
"model": "gpt-image-2",
"prompt": "生成一张 16:9 横屏风景图，美丽的日出，金色阳光洒在宁静湖面上，远处连绵山脉",
"aspect_ratio": "auto"
}不指定固定比例，模型从提示词中读取“16:9”并按此生成。
文生图 — 2K / 4K 档位
{
"model": "gpt-image-2-4K",
"prompt": "生成抖音带货风格主图，主体 xxx",
"aspect_ratio": "9:16"
}将 model改为gpt-image-2-2K或gpt-image-2-4K即可，aspect_ratio用法与标准档相同。
图生图 — Base64 格式
{
"model": "gpt-image-2",
"prompt": "将这张图片转换成油画风格",
"aspect_ratio": "9:16",
"images": [
"data:image/jpeg;base64,/9j/4AAQSkZJRg...",
"data:image/png;base64,iVBORw0KGgoAAAANSU..."
]
}图生图 — URL 格式
{
"model": "gpt-image-2",
"prompt": "将这张图片转换成油画风格",
"aspect_ratio": "16:9",
"images": [
"https://example.com/images/reference1.jpg",
"https://example.com/images/reference2.png"
]
}请求参数
Header 参数
Body 参数application/json
请求示例代码
返回响应
修改于 2026-07-24 02:31:24