获取 API Key 获取 API
文档

GPT-Image(1/1.5) 图像生成

- 异步处理模式,返回任务ID用于后续查询

  • 支持文生图、图生图、局部重绘等多种生成模式
  • 支持透明背景、多种输出格式、多质量档位
  • 单次最多生成 4 张图片,参考图最多 15 张

请求示例

curl --request POST \
  --url https://api.openveer.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1-official",
    "prompt": "星空下的古老城堡",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

响应示例

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KXXXXXXXXXXXXXXX"
    }
  ]
}

支持的模型

模型名 说明 模式 图生图 最大张数 计费方式
gpt-image-1-official 稳定优先,适合通用图片生成 文生图 / 图生图 支持 4 张 尺寸×质量
gpt-image-1.5-official 新版本,适合更高质量和更复杂编辑场景 文生图 / 图生图 支持 4 张 尺寸×质量

Authorizations

Authorization string

所有接口均需要使用Bearer Token进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

Body

model string

模型名称

  • gpt-image-1-official - 稳定优先,适合通用图片生成
  • gpt-image-1.5-official - 新版本,适合更高质量和更复杂编辑场景
prompt string

图像生成的文本描述,支持中英文

size string

画面比例

支持的比例:

  • 1:1 - 正方形构图(默认)
  • 3:2 - 横构图
  • 2:3 - 竖构图
n integer

生成图片张数

取值范围:1-4

  • 传入值 ≤ 0 时,系统按 1 处理
  • 传入值 > 4 时,系统按 4 处理

⚠️ 注意: 必须输入纯数字(如 1),不要加引号,否则会报错

quality string

图片质量

  • auto - 自动选择质量(默认)
  • low - 更快、更省
  • medium - 质量与消耗折中
  • high - 质量更高,消耗更高
background string

背景模式

  • auto - 自动背景(默认)
  • opaque - 不透明背景
  • transparent - 透明背景,推荐搭配 png 输出格式

警告



background: transparent 不能和 output_format: jpeg 同时使用

moderation string

审核强度

  • auto - 默认审核强度
  • low - 更宽松的审核强度
output_format string

输出格式

  • png - 默认格式,适合透明背景
  • jpeg - 文件更小,适合普通图片输出

警告



background: transparent 不能和 output_format: jpeg 同时使用

output_compression integer

输出压缩强度,范围 0-100

  • 建议仅在 jpeg 下使用
  • png 场景建议不传
image_urls array

参考图像的 URL 数组,传入后自动按图生图处理

* 传 1 张为单参考图编辑
* 传 2-15 张为多参考图融合编辑
* 超过 15 张服务端会拒绝处理
* 必须是公网可访问的稳定图片 URL

限制: 最多 15 张参考图

mask_url string

遮罩图 URL,用于局部重绘(inpainting)

  • 需搭配 image_urls 一起使用
  • 传入后会按官方编辑接口一并提交

警告



1、上传遮罩图前,请先确认图片 Alpha 通道为「是」。

2、遮罩图尺寸需与首张参考图一致。

尺寸对照表

对外统一使用比例值,系统内部自动映射到官方实际尺寸并完成计费。

比例 实际尺寸 说明
1:1 1024×1024 正方形构图
2:3 1024×1536 竖构图
3:2 1536×1024 横构图

使用场景示例

文生图(最简请求)

{
  "model": "gpt-image-1-official",
  "prompt": "星空下的古老城堡"
}

文生图(完整参数)

{
  "model": "gpt-image-1-official",
  "prompt": "A flat icon of a glass bottle with no background",
  "size": "2:3",
  "quality": "high",
  "background": "transparent",
  "moderation": "low",
  "output_format": "png",
  "n": 1
}

图生图(单参考图)

{
  "model": "gpt-image-1.5-official",
  "prompt": "将参考图改成插画风格,保留主体轮廓",
  "size": "1:1",
  "quality": "auto",
  "image_urls": [
    "https://your-cdn.com/input.png"
  ],
  "n": 1
}

图生图(多参考图融合)

{
  "model": "gpt-image-1.5-official",
  "prompt": "将两张参考图融合成一张插画海报,保留主体轮廓",
  "size": "1:1",
  "quality": "auto",
  "background": "transparent",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ],
  "moderation": "low",
  "output_format": "png",
  "n": 1
}

多张生成(n > 1)

{
  "model": "gpt-image-1-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1:1",
  "quality": "low",
  "output_format": "png",
  "n": 4
}

Response

code integer

响应状态码

data array
返回数据数组
status string

任务状态

  * submitted - 已提交
task_id string

任务唯一标识符

注意事项

  1. 异步处理:提交后返回 task_id,需轮询 /v1/tasks/{task_id} 获取结果
  2. 模型选择:通用图片生成优先使用 gpt-image-1-official,高质量编辑和复杂图生图建议使用 gpt-image-1.5-official
  3. 图片 URL 要求:图生图推荐使用公网可直接访问的稳定图片 URL
  4. 计费规则:按成功生成的图片张数计费,失败不扣费