图像接口

使用 POST /v1/images/generations 创建图像任务。接口会返回任务 id，最终图片需要到任务查询里获取。

接口地址

POST /v1/images/generations

请求头

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

请求参数

字段	类型	是否必填	说明
`prompt`	string	必填	你想生成的画面。建议写清主体、风格、光线和构图。
`model`	string	可选	图像模型。默认是 `gpt-image-2-all`，也可以传 `gpt-image-1.5-all`。
`provider`	string	可选	图像服务。默认使用 GPT Image 2 图像服务。
`n`	number	可选	生成数量。可选 `1`、`2`、`4`，默认 `1`。
`size`	string	可选	1K 图片比例或像素尺寸，例如 `1:1`、`4:5`、`16:9`、`9:16`、`1024x1024`。
`resolution`	string	可选	输出分辨率。`1k` 是标准图，`4k` 是高清图，默认 `1k`。
`imageResolution`	string	可选	和 `resolution` 含义相同，方便已有客户端沿用这个字段名。
`imageSizePreset`	string	可选	图片比例预设，尤其适合 4K 图片请求。

尺寸和分辨率

1K 图片常用预设：

预设	输出尺寸
`1:1`	`1024x1024`
`4:5`	`1024x1280`
`16:9`	`1536x864`
`9:16`	`864x1536`

4K 图片把 resolution 设为 4k，再选择支持的比例，例如 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 图片：每张 2 积分。
4K 图片：每张 4 积分。
n 大于 1 时，按图片张数累计消耗积分。

示例：1K 正方形图片

curl https://gptimge.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-all",
    "prompt": "一瓶高端护肤品放在暖米色展台上，棚拍灯光，真实阴影",
    "size": "1:1",
    "n": 1
  }'

示例：16:9 横图

curl https://gptimge.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-all",
    "prompt": "日出时山间木屋的电影感画面，宽幅风景构图",
    "size": "16:9",
    "n": 1
  }'

示例：4K 图片

curl https://gptimge.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-all",
    "prompt": "奢华腕表微距照片，金属细节清晰，反光有层次",
    "resolution": "4k",
    "imageSizePreset": "1:1",
    "n": 1
  }'

返回结果

这个接口返回的是任务，不是最终图片文件。

{
  "id": "task_id",
  "object": "image.generation.task",
  "status": "pending",
  "data": [
    {
      "id": "task_id",
      "mediaType": "image",
      "status": "pending",
      "imageUrls": []
    }
  ]
}

用 GET /v1/tasks/{id} 查询最终的 imageUrls。

图像接口

On this page