跳转到正文MaoMaoToken
控制台

GPT 特惠系列

模型与价格

模型名称系列调用价计费方式文生图图片编辑N 值范围参考图蒙版能力蒙版张数
gpt-image-2-Sale特惠¥0.0350按张支持支持1-109张支持1
gpt-image-2.5-flare-Sale特惠¥0.0500按张支持支持1-109张支持1
gpt-image-2.5-sunburst-Sale特惠¥0.0500按张支持支持1-109张支持1
  • 三款模型均支持文生图和图片编辑;
  • 单次可生成 1~10 张图片,编辑时最多使用 9 张参考图片,并可额外提供 1 张蒙版;
  • 支持同步和异步调用,新接入推荐使用异步;
  • 参考图片和蒙版请使用可访问的 HTTPS 地址;
  • 特惠渠道价格较低,但不保证长期稳定供应;

接口

接口说明方法路径
图片生成异步提交POST/v1/images/generations
图片生成异步查询GET/v1/images/generations/{task_id}
图片编辑异步提交POST/v1/images/edits
图片编辑异步查询GET/v1/images/edits/{task_id}
图片生成同步POST/v1/images/generations
图片编辑同步POST/v1/images/edits
  • 同一次任务请选择同步或异步其中一种方式提交,无需重复调用;
  • 两种方式使用相同的模型参数,仅异步标记和结果获取方式不同,新接入推荐使用异步;
  • 具体接入步骤请参阅「图片同步接口」或「图片异步接口」;

请求参数

字段释义说明
model模型名称从上方模型列表中选择一款,并原样传入对应的模型名称。
prompt提示词图片描述或编辑要求,不能为空;多图编辑时可使用 @Image1、@Image2 等编号明确指代参考图。
n生成张数生成图片张数,支持 1~10。
size尺寸比例支持 1:1 / 16:9 / 9:16 / 3:2 / 2:3 / 4:3 / 3:4 / 5:4 / 4:5 / 21:9,也可填写 auto。请勿自行换算为像素尺寸。
response_format返回格式推荐填写 url,通过 HTTPS 图片地址获取结果。
async接口选择true为异步,创建后通过对应查询端点轮询;未启用其他异步标记时,省略或false为同步等待。
images参考图参考图片 HTTPS URL 数组,最多 9 张;文生图无需填写。
mask蒙版图片编辑时使用的蒙版 HTTPS URL,最多 1 张;不使用蒙版时省略。
  • 参考图片仅传公网可访问的 HTTPS URL;
  • 不要发送 aspect_ratio、image_size、output_resolution,以及本表未列出的字段;
  • model 字段必须使用上方列表中的完整名称;
  • 不同模型的请求格式相同,只需替换该字段的值;
  • 不要自行添加分辨率后缀,或将模型名称换算为某个像素尺寸;

异步请求示例

文生图

请求端点:POST /v1/images/generations

{
  "model": "gpt-image-2-Sale",
  "prompt": "一座临海的白色建筑,午后阳光,简洁构图,真实摄影风格。",
  "n": 1,
  "size": "1:1",
  "response_format": "url",
  "async": true
}

图片编辑

请求端点:POST /v1/images/edits

{
  "model": "gpt-image-2-Sale",
  "prompt": "保留参考图片中的建筑主体,将场景改为傍晚,天空呈淡粉色,窗户透出温暖灯光。",
  "images": [
    "https://example.com/reference.png"
  ],
  "n": 1,
  "size": "1:1",
  "response_format": "url",
  "async": true
}

多图编辑

请求端点:POST /v1/images/edits

{
  "model": "gpt-image-2-Sale",
  "prompt": "参考 @Image1 中的建筑主体和 @Image2 中的配色,将两者融合为一张统一风格的临海建筑效果图。",
  "images": [
    "https://example.com/building.png",
    "https://example.com/color-reference.png"
  ],
  "n": 1,
  "size": "1:1",
  "response_format": "url",
  "async": true
}
  • 在 images 数组中按顺序传入多张参考图片,最多支持 9 张;
  • 在 prompt 中使用 @Image1、@Image2 等编号指代对应图片;
  • @Image1 对应 images[0],@Image2 对应 images[1],后续以此类推;

蒙版编辑

请求端点:POST /v1/images/edits

{
  "model": "gpt-image-2-Sale",
  "prompt": "将蒙版指定的编辑区域替换为一片盛开的花丛,与原图的光线和风格保持一致。",
  "images": [
    "https://example.com/reference.png"
  ],
  "mask": "https://example.com/mask.png",
  "n": 1,
  "size": "1:1",
  "response_format": "url",
  "async": true
}
  • 通过 images 提供原始图片,通过 mask 提供蒙版图片,并在 prompt 中描述编辑要求;
  • 以上示例中的图片和蒙版地址仅为占位,请替换为公网可访问的 HTTPS 图片链接;

结果获取

同步调用

请求会等待图片生成完成后返回结果。

使用 response_format: "url" 时,从响应中获取图片链接。

异步调用

提交成功后会返回任务 ID,此时图片可能尚未生成完成。

请使用该 ID 查询任务状态,待任务成功完成后获取图片链接。

文生图与图片编辑分别使用以下查询端点:

任务类型查询端点
文生图GET /v1/images/generations/{task_id}
图片编辑(含蒙版编辑)GET /v1/images/edits/{task_id}

具体返回格式与查询方式,请参阅「图片同步接口」或「图片异步接口」。

图片链接不建议作为永久存储地址,最大有效期限为 24 小时,获取结果后请及时下载并保存。

本页内容

On this page