Skip to main content

1. 获取 API Key

打开 Ace Data Cloud 应用列表,进入可用的应用并复制 API Key。 获取 Ace Data Cloud API Key

2. 使用图片 URL 编辑

原图: GPT Image 2 编辑原图
成功响应:
这是 2026 年 9 月 8 日通过 Ace Data Cloud 实际完成的编辑结果,杯子变为橙色、背景变为深海军蓝,并保持原始构图和 1024×1536 尺寸: GPT Image 2 橙色马克杯编辑结果

3. 上传本地图片

使用 multipart/form-data
可重复传入 image,GPT Image 系列最多支持 16 张参考图。JSON 请求中的 image 可以是单个 URL 或 URL 数组;本地文件使用 multipart 上传。

模型与计费方式

官方 API 通道的页面价格是请求前估算,最终以响应中的实际 Token 用量和使用记录为准。

4. 使用蒙版局部编辑

官方 Images Edit 接口通过 mask 指定允许修改的区域。Ace Data Cloud 的 :official 模型遵循相同的 multipart 契约:
  • mask 必须是带 Alpha 通道的 PNG,大小不超过 4MB;
  • 蒙版尺寸必须与第一张 image 完全一致;
  • Alpha 为 0 的透明像素表示允许编辑,非透明像素表示应保留;
  • 只有颜色为黑白、但没有透明通道的 RGB 图片不能作为有效蒙版;
  • 提示词应描述期望得到的完整画面,同时明确局部修改和需要保持不变的内容。
下面先从原图生成一个蒙版。示例将中央矩形设为透明,只允许模型修改该区域:
然后把原图和蒙版一起上传:
也可以沿用 OpenAI 官方 Python SDK 的 images.edit 调用方式,只需把 base_url 指向 Ace Data Cloud:
使用 mask 时,原图和蒙版必须在同一个 multipart 请求中分别通过 image=@input.pngmask=@mask.png 上传。不要把 URL 原图与本地蒙版文件混合传入;纯 URL 编辑请求不支持再附加本地 mask 文件。蒙版会约束编辑区域,但生成模型仍可能对边缘进行自然融合;需要严格边界时,应使用清晰的 Alpha 边缘并在提示词中重复说明哪些内容必须保持不变。 以上调用方式与 OpenAI Image Edit APIGPT Image 官方 Cookbook 的蒙版示例一致。

5. 常用参数

尺寸规则与生成接口一致:宽高须为 16 的倍数,长边不超过 3840,总像素为 655,360–8,294,400,宽高比不超过 3:1。省略 size 或使用 auto 时,模型会结合提示词和第一张参考图选择画幅。 gpt-image-2gpt-image-2.5-flaregpt-image-2.5-sunburstgpt-image-2:reverse 按成功张数计费;gpt-image-2:officialgpt-image-2.5-flare:officialgpt-image-2.5-sunburst:official 根据文字输入、参考图输入和图片输出的实际 Token 结算,最终以使用记录为准。

6. 异步回调与排错

长任务可在请求中加入:
异步 200 响应为 {"task_id": "..."};完成后回调最终结果。同步请求则返回 createddata 错误响应会包含 trace_id。反馈问题时提供该 ID,不要提供 API Key。 完整字段和实时枚举以 OpenAI Images Edits API 页面为准。纯文本生成图片请查看 GPT Image 2 / 2.5 图像生成