Skip to main content
POST
https://www.geeknow.top
/
v1
/
images
/
generations
gpt-image-2-pro 生成图像 API
curl --request POST \
  --url https://www.geeknow.top/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "n": 123,
  "size": "<string>",
  "image": [
    "<string>"
  ],
  "response_format": "<string>",
  "quality": "<string>",
  "style": {},
  "background": {},
  "watermark": true
}
'
{
  "created": 1735689600,
  "data": [
    {
      "url": "https://.../images/img-pro-abc123.png",
      "revised_prompt": "一张电影级科技城市全景海报，清晨雾气，纵深透视，细节丰富"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.geeknow.top/llms.txt

Use this file to discover all available pages before exploring further.

​
gpt-image-2-pro 生成图像 API

gpt-image-2-pro 与 gpt-image-2 共用统一图像生成入口，但额外开放了 2K、4K 高分辨率档位，适合需要更大画幅和更高输出尺寸的场景。
  • 统一入口为 POST /v1/images/generations。
  • 通过 model = "gpt-image-2-pro" 选择目标模型。
  • 除基础尺寸外，还补充 2K、4K 高分档位。
  • 支持 url 和 b64_json 两种返回格式。
  • 可在 JSON 中附带 image 作为参考图，是否生效取决于实际命中的图像渠道。

​
方法与路径

POST /v1/images/generations

​
请求示例

curl -X POST https://www.geeknow.top/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-pro",
    "prompt": "一张电影级科技城市全景海报，清晨雾气，纵深透视，细节丰富",
    "n": 1,
    "size": "3840x2160",
    "response_format": "url"
  }'

​
响应示例

{
  "created": 1735689600,
  "data": [
    {
      "url": "https://.../images/img-pro-abc123.png",
      "revised_prompt": "一张电影级科技城市全景海报，清晨雾气，纵深透视，细节丰富"
    }
  ]
}

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
required
固定传 gpt-image-2-pro。
​
prompt
string
生成提示词。对于文生图语义应视为必填。
​
n
integer
生成数量。若不传或显式传 0，统一层回退为 1。
​
size
string
输出尺寸。除基础档位外，还支持高分辨率扩展档位。
​
image
string | array<string> | object
可选参考图输入。常见写法是 Base64 字符串或 Base64 数组。
​
response_format
string
返回格式，常见值为 url、b64_json。
​
quality
string
质量字段。是否真正生效取决于最终命中的渠道。
​
style
string | object
风格字段，原样透传给支持的上游。
​
background
string | object
背景控制字段，原样透传给支持的上游。
​
watermark
boolean
显式水印开关。false 与不传语义不同。

​
高分辨率档位

​
2K 扩展档位

预设实际目标尺寸
1:1(2K)2048x2048
4:3(2K)2048x1536
3:2(2K)2560x1712
2:3(2K)1712x2560
16:9(2K)2048x1152
9:16(2K)1152x2048

​
4K 扩展档位

预设实际目标尺寸
1:1(4K)2880x2880
4:3(4K)3840x2880
3:2(4K)3840x2560
2:3(4K)2560x3840
16:9(4K)3840x2160
9:16(4K)2160x3840
这些高分档位反映的是插件侧暴露的目标尺寸。若上游不原生接受对应尺寸，网关或插件可能回退到更接近的官方尺寸，并把比例意图附加到 prompt。

​
Response

​
created
integer
生成时间戳。
​
data[].url
string
response_format = url 时返回的图片 URL。
​
data[].b64_json
string
response_format = b64_json 时返回的图片 Base64 数据。
​
data[].revised_prompt
string
部分上游会改写提示词并返回在这个字段里。

​
相关接口