Skip to main content
POST

支持的模型

Authorizations

string
必填
所有接口均需要使用Bearer Token进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

Body

string
必填
模型名称
  • gpt-image-1-official - 稳定优先,适合通用图片生成
  • gpt-image-1.5-official - 新版本,适合更高质量和更复杂编辑场景
string
必填
图像生成的文本描述,支持中英文
string
默认值:"1:1"
画面比例支持的比例:
  • 1:1 - 正方形构图(默认)
  • 3:2 - 横构图
  • 2:3 - 竖构图
integer
默认值:"1"
生成图片张数取值范围:1-4
  • 传入值 ≤ 0 时,系统按 1 处理
  • 传入值 > 4 时,系统按 4 处理
⚠️ 注意: 必须输入纯数字(如 1),不要加引号,否则会报错
string
默认值:"auto"
图片质量
  • auto - 自动选择质量(默认)
  • low - 更快、更省
  • medium - 质量与消耗折中
  • high - 质量更高,消耗更高
string
默认值:"auto"
背景模式
  • auto - 自动背景(默认)
  • opaque - 不透明背景
  • transparent - 透明背景,推荐搭配 png 输出格式
background: transparent 不能和 output_format: jpeg 同时使用
string
默认值:"auto"
审核强度
  • auto - 默认审核强度
  • low - 更宽松的审核强度
string
默认值:"png"
输出格式
  • png - 默认格式,适合透明背景
  • jpeg - 文件更小,适合普通图片输出
background: transparent 不能和 output_format: jpeg 同时使用
integer
输出压缩强度,范围 0-100
  • 建议仅在 jpeg 下使用
  • png 场景建议不传
array
参考图像的 URL 数组,传入后自动按图生图处理限制: 最多 15 张参考图
string
遮罩图 URL,用于局部重绘(inpainting)
  • 需搭配 image_urls 一起使用
  • 传入后会按官方编辑接口一并提交
1、上传遮罩图前,请先确认图片 Alpha 通道为「是」。2、遮罩图尺寸需与首张参考图一致。

尺寸对照表

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

使用场景示例

文生图(最简请求)
文生图(完整参数)
图生图(单参考图)
图生图(多参考图融合)
多张生成(n > 1)

Response

integer
响应状态码
array
返回数据数组

注意事项

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