Skip to content

GPT Image 2 图像生成​

POST
/v1/images/generations

🤖 本页是给 AI Agent 读的接口文档

人类用户只需按「如何使用」中的方法教会 AI 怎么用。

GPT Image 2 同时支持文生图和图生图:既可以根据提示词从零生成图像,也可以使用 1–16 张参考图完成风格重绘、背景替换和多参考图融合。

  • 支持横图、竖图、正方形和超宽画幅等多种构图比例。
  • 支持 1k、2k、4k 三档输出,适合从快速预览到高分辨率成图。
  • 图生图可混合使用公网 HTTPS 图像与 base64 图像,便于组合不同来源的参考素材。
  • ClawPower 会等待生成完成,直接返回原始图片字节的 Base64,无需处理供应商任务 ID 或轮询。
  • 每次请求目前固定生成 1 张图像,实际图片格式以响应中的 output_format 为准。
  • 这是同步接口。客户端读取超时请设为 480 秒;服务端实际等待上限以当前部署配置为准。
  • 部分图像比例与分辨率不能组合使用,具体限制见下方 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
模式

请求体​

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

响应​

生成成功。返回一张保留原始字节的图像。

application/json
JSON
{
  
"created": 1787270400,
  
"data": [
  
  
{
  
  
  
"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
  
  
}
  
],
  
"output_format": "png",
  
"size": "2048x1152"
}

试验场​

授权
主体

示例​

保存返回的图像 ​

成功响应中的 data[0].b64_json 是不带 data URI 前缀的原始图片 Base64。下面的 Python 示例根据返回的 output_format 选择文件扩展名:

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=480,
)
response.raise_for_status()

result = response.json()
extensions = {"png": ".png", "jpeg": ".jpg", "webp": ".webp"}
filename = "output" + extensions[result["output_format"]]

with open(filename, "wb") as image_file:
    image_file.write(base64.b64decode(result["data"][0]["b64_json"], validate=True))

NOTE

这是同步接口。客户端读取超时请设为 480 秒;服务端实际等待上限以当前部署配置为准;不要按异步任务接口处理,也不需要轮询任务状态。

联系加微信 clawpower