GPT-Image-2

OpenAI Images API 兼容的图像生成与编辑接口，支持 1K、2K 和企业 4K 档位。

图生图提示: 生成接口不再接收内联 base64 图片数据。请先使用文件上传接口上传图片获取 URL,再把 URL 放进 images 或 image_urls。

调用示例

curl https://cokeapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只在京都樱花树下的赛博狐狸,电影质感,Portra 400 胶片",
    "size": "16:9",
    "quality": "2k",
    "n": 1
  }'

curl https://cokeapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "把背景换成赛博朋克霓虹街道,保留主体",
    "size": "16:9",
    "quality": "2k",
    "n": 1,
    "image_urls": ["https://cdn.cokeapi.com/uploads/2026/05/17/photo.png"]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://cokeapi.com/v1",
    api_key="sk-xxxxxxxx",
)
img = client.images.generate(
    model="gpt-image-2",
    prompt="一只在京都樱花树下的赛博狐狸,电影质感",
    n=2,
    size="16:9",
    quality="2k",
)

for d in img.data:
    print(d.url)

from openai import OpenAI

client = OpenAI(
    base_url="https://cokeapi.com/v1",
    api_key="sk-xxxxxxxx",
)

img = client.images.generate(
    model="gpt-image-2",
    prompt="把背景换成赛博朋克霓虹街道,保留主体",
    n=1,
    size="16:9",
    quality="2k",
    extra_body={
        "image_urls": ["https://cdn.cokeapi.com/uploads/2026/05/17/photo.png"],
    },
)

for d in img.data:
    print(d.url)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cokeapi.com/v1",
  apiKey: process.env.COKEAPI_KEY,
});
const img = await client.images.generate({
  model: "gpt-image-2",
  prompt: "一只在京都樱花树下的赛博狐狸,电影质感",
  n: 2,
  size: "16:9",
  quality: "2k",
});

img.data.forEach((d) => console.log(d.url));

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cokeapi.com/v1",
  apiKey: process.env.COKEAPI_KEY,
});

const img = await client.images.generate({
  model: "gpt-image-2",
  prompt: "把背景换成赛博朋克霓虹街道,保留主体",
  n: 1,
  size: "16:9",
  quality: "2k",
  extra_body: {
    image_urls: ["https://cdn.cokeapi.com/uploads/2026/05/17/photo.png"],
  },
});

img.data.forEach((d) => console.log(d.url));

请求参数

参数	类型	必填	默认值	说明
model	string	是	—	固定为 `gpt-image-2`
prompt	string	是	—	最长 32,000 个字符
size	string	否	1:1	输出图像比例，见下方尺寸对照表
quality	string	否	1k	分辨率档位 `1k` / `2k` / `4k`
n	int	否	1	一次出图数量
response_format	string	否	url	返回格式，固定为 `url`
images	string[]	否	—	参考图 URL 列表，用于图生图
image_urls	string[]	否	—	与 `images` 等价的参考图字段，二者任选其一

尺寸对照表

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
`21:9`	2016×864	2688×1152	3840×1648
`9:21`	864×2016	1152×2688	1648×3840

响应示例

创建成功后立即返回任务状态,后续通过异步任务查询结果:

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

计费

按 图片张数 × 单价 扣费,不同 quality 档位价格不同:

分辨率档	单价 (美元/张)
1K	$0.024
2K	$0.032
4K	$0.040

完整实时价目以模型列表页为准,本页价格为 2026-07 快照。失败请求(含上游 502)全额退款,不计费。

错误码

code	type	含义	HTTP
400101	`invalid_param`	参数错误 (尺寸不支持等)	400
400401	`insufficient_balance`	余额不足	400
401104	`api_key_invalid`	API Key 无效	401
429101	`rate_limit_exceeded`	RPM 超限	429
429302	`daily_quota_exceeded`	每日调用配额耗尽	429
502201	`upstream_unavailable`	GPT 服务暂不可用	502
502203	`no_available_account`	暂无可用账号	502

完整列表见错误码。

注意事项

CDN 图片 URL 24 小时后失效,需长期保存请下载到自有存储。
gpt-image-2 对 prompt 中的文字渲染较弱,建议拆分"场景描述 + 风格关键词"。
reference_images 字段不存在(仅视频接口有),图生图参考图请用 images 或 image_urls。
失败请求 (含上游 502) 全额返还本次扣费,不计费。

调用示例

请求参数

尺寸对照表

响应示例

计费

错误码

注意事项

本页目录