主题
GPT Image 2 图像生成
POST
/v1/images/generations
GPT Image 2 同时支持文生图和图生图：既可以根据提示词从零生成图片，也可以使用 1–16 张参考图完成风格重绘、背景替换和多参考图融合。
- 支持横图、竖图、正方形和超宽画幅等多种构图比例。
- 支持
1k、2k、4k三档输出，适合从快速预览到高分辨率成图。 - 图生图可混合使用公网 HTTPS 图片与 base64 图片，便于组合不同来源的参考素材。
- ClawPower 会等待生成完成，直接返回统一的 PNG base64，无需处理供应商任务 ID 或轮询。
- 每次请求目前固定生成 1 张图片，输出格式固定为 PNG。
- 这是同步接口，生成、结果下载和格式转换最长等待 180 秒，客户端超时应设置得更长。
- 部分图片比例与分辨率不能组合使用，具体限制见下方
size和resolution字段说明。
模型
请求体中的 model 固定填写下面的模型 ID。
gpt-image-2价格
| 分辨率 | 单张售价 |
|---|---|
1k | ¥0.10 / $0.0147 |
2k | ¥0.20 / $0.0294 |
4k | ¥0.30 / $0.0441 |
认证
使用 ClawPower API Key 进行 Bearer 认证，并在请求头中传入：
Authorization: Bearer <CLAWPOWER_API_KEY>类型 HTTP (bearer)
请求体
application/json
要调用的模型 ID。固定填写 gpt-image-2，不支持别名或其他模型名称。
有效值
"gpt-image-2"图片生成或编辑说明。文生图时描述主体、场景、构图和风格；图生图时说明要保留什么、修改什么。
必须是非空 UTF-8 字符串，去除首尾空白后不能为空，最长 20000 个字符。
最小长度
1最大长度
20000输出图片的宽高比例，不是像素尺寸。横图可选 3:2、4:3、5:4、16:9、2:1、3:1、21:9；竖图可选 2:3、3:4、4:5、9:16、1:2、1:3、9:21；另支持 1:1 和 auto。
文生图省略时默认为 1:1；图生图省略时默认为 auto。不支持 1024x1024 这类像素尺寸。
有效值
"auto""1:1""3:2""2:3""4:3""3:4""5:4""4:5""16:9""9:16""2:1""1:2""3:1""1:3""21:9""9:21"输出分辨率档位，省略时默认为 1k。分辨率越高，图片尺寸和价格档位越高。
与 size 的组合限制：
auto：仅支持1k。1:1：支持1k、2k。5:4、4:5、3:1、1:3、9:21：仅支持1k。- 其余比例：支持
1k、2k、4k。 - 图生图显式使用
2k或4k时，必须同时显式传入size。
有效值
"1k""2k""4k"默认
"1k"参考图数组。省略时执行文生图；传入时执行图生图。
- 数量：1–16 张。
- 类型：公网可访问的 HTTPS URL，或 PNG、JPEG、WebP 的 base64 data URI。
- 混用：同一数组内可以同时传 URL 和 base64。
- 大小：单张图片最大 20 MB，所有参考图原始数据合计最大 64 MB。
- URL 安全：最多跟随 5 次安全 HTTPS 重定向，不能访问本机、内网或云元数据地址。
最小项数
1最大项数
16响应
生成成功。返回一张已经验证并统一转换为 PNG 的图片。
application/json
JSON "created": 1787270400, "data": [ { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." } ], "output_format": "png", "size": "2048x1152"
{
}
保存返回的图片
成功响应中的 data[0].b64_json 是不带 data URI 前缀的 PNG base64。下面的 Python 示例会把它保存为 output.png：
python
import base64
import requests
response = requests.post(
"https://api.clawpowerai.com/v1/images/generations",
headers={
"Authorization": "Bearer <CLAWPOWER_API_KEY>",
"Content-Type": "application/json",
},
json={
"model": "gpt-image-2",
"prompt": "一只橘猫坐在窗边看夕阳，水彩插画",
"size": "16:9",
"resolution": "2k",
},
timeout=200,
)
response.raise_for_status()
with open("output.png", "wb") as image_file:
image_file.write(base64.b64decode(response.json()["data"][0]["b64_json"]))NOTE
这是同步接口。客户端超时应大于服务端最长 180 秒的等待时间；不要按异步任务接口处理，也不需要轮询任务状态。