API DOCUMENT

GPT 生图接口

通过纯梦 API 调用 GPT 生图能力，支持提示词生图和参考图。所有请求统一使用 Authorization Bearer 鉴权。

价格

基础生成价格为 0.10 元/次。每传入 1 张参考图，额外增加 0.10 元。

参考图数量	本次价格
0 张	0.10 元
1 张	0.20 元
2 张	0.30 元
3 张	0.40 元

创建任务时先冻结本次费用；任务成功后确认扣费；创建失败或任务失败会退回冻结金额。

创建生成任务

请求地址

POST https://puream.cn/api/ai/gpt-image-2/v1/images/generations

请求 Header

名称	必填	说明
`Authorization`	是	`Bearer 你的纯梦 API Key`
`Content-Type`	是	`application/json`

请求参数

字段	类型	必填	说明
`prompt`	string	是	图片生成提示词。
`size`	string	否	图片比例或尺寸，例如 `9:16`、`1:1`、`16:9`。
`reference_images`	string[]	否	参考图 URL 数组。每张参考图额外计费 0.10 元。
`image_urls`	string[]	否	参考图 URL 数组，也会按参考图计费。
`其他扩展字段`	any	否	其他字段会与默认生成参数合并后提交。

请求示例：无参考图

{
  "prompt": "北京四合院震撼俯拍，电影级光影，超清细节",
  "size": "9:16"
}

请求示例：带 2 张参考图

{
  "prompt": "参考图片里的商品，生成高端电商主图，干净背景，真实光影",
  "size": "1:1",
  "reference_images": [
    "https://example.com/product-front.png",
    "https://example.com/product-side.png"
  ]
}

返回说明

创建成功后通常会返回任务 ID，请使用任务 ID 查询生成结果。若直接返回最终结果，系统会直接确认本次扣费。

参考图 URL 需要能公网访问。带防盗链、临时签名失效或需要登录的图片链接，可能无法读取。

查询任务结果

请求地址

GET https://puream.cn/api/ai/gpt-image-2/v1/tasks/任务ID

curl "https://puream.cn/api/ai/gpt-image-2/v1/tasks/任务ID" \
  -H "Authorization: Bearer 你的纯梦APIKey"

任务成功后确认扣费；任务失败或查询失败时退回冻结金额；任务仍在处理中时继续保持冻结。