GPT Image 2.5 Sunburst 图像生成

POST

/v1/images/generations

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

支持横图、竖图、正方形和超宽画幅等多种构图比例。
支持 1k、2k、4k 三档输出，适合从快速预览到高分辨率成图。
图生图可混合使用公网 HTTPS 图像与 base64 图像，便于组合不同来源的参考素材。
ClawPower 会等待生成完成，直接返回统一的 PNG base64，无需处理内部任务。

每次请求固定生成 1 张图像，输出格式固定为 PNG。

这是同步接口，生成、结果下载和格式转换最长等待 300 秒，客户端超时应设置得更长。

模型

请求体中的 model 固定填写下面的模型 ID。

gpt-image-2.5-sunburst

价格

分辨率	单张售价
`1k`	¥0.10 / $0.0147
`2k`	¥0.20 / $0.0294
`4k`	¥0.30 / $0.0441

文生图与图生图同档同价，参考图不额外加价；每次固定输出 1 张。失败费用口径尚未单独验证。

认证

使用 ClawPower API Key 进行 Bearer 认证，并在请求头中传入：

Authorization: Bearer <CLAWPOWER_API_KEY>

类型 HTTP (bearer)

请求体

application/json

要调用的模型 ID。固定填写 gpt-image-2.5-sunburst，不支持别名或其他模型名称。

有效值"gpt-image-2.5-sunburst"

图像生成或编辑说明。文生图时描述主体、场景、构图和风格；图生图时说明要保留什么、修改什么。

必须是非空 UTF-8 字符串，去除首尾空白后不能为空，最长 20000 个字符。

最小长度1

最大长度20000

输出图像的宽高比例，不是像素尺寸。省略时默认为 auto；可选 auto、1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、21:9。

有效值"auto""1:1""16:9""9:16""4:3""3:4""3:2""2:3""5:4""4:5""21:9"

默认"auto"

输出分辨率档位，省略时默认为 1k。可选 1k、2k、4k；任意已支持画幅均可搭配任意已支持分辨率。

有效值"1k""2k""4k"

默认"1k"

参考图数组。省略时执行文生图；传入时执行图生图。

数量：1–16 张。
类型：公网可访问的 HTTPS URL，或 PNG、JPEG、WebP 的 base64 data URI。
同一数组内可以同时传 URL 和 base64。

最小项数1

最大项数16

响应

生成成功。返回一张已经验证并统一转换为 PNG 的图像。

Content-Type

application/json

JSON

{

"created": 1787270400,

"data": [

{

"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."

}

"output_format": "png",

"size": "2048x1152"

}

POST

/v1/images/generations

试验场

授权

bearerAuth

主体

示例

保存返回的图像

成功响应中的 data[0].b64_json 是不带 data URI 前缀的 PNG base64。下面的 Python 示例会把它保存为 output.png：

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.5-sunburst",
        "prompt": "一只橘猫坐在窗边看夕阳，水彩插画",
        "size": "16:9",
        "resolution": "2k",
    },
    timeout=320,
)
response.raise_for_status()

with open("output.png", "wb") as image_file:
    image_file.write(base64.b64decode(response.json()["data"][0]["b64_json"]))

NOTE

这是同步接口。客户端超时应大于服务端最长 300 秒的等待时间；不需要查询任务状态。当前可用性为已可用，已在生产环境验证 1K 文生图；图生图及其他分辨率尚未逐项完成生产验证。

GPT Image 2.5 Sunburst 图像生成​

模型 ​

价格 ​

认证 ​

请求体​

响应​

试验场​

示例​

保存返回的图像 ​

GPT Image 2.5 Sunburst 图像生成

模型

价格

认证

请求体

响应

试验场

示例

保存返回的图像