1. 获取 API Key
打开 Ace Data Cloud 应用列表,进入可用的应用并复制 API Key。
2. 使用图片 URL 编辑
原图:
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 图片不能作为有效蒙版;
- 提示词应描述期望得到的完整画面,同时明确局部修改和需要保持不变的内容。
images.edit 调用方式,只需把 base_url 指向 Ace Data Cloud:
mask 时,原图和蒙版必须在同一个 multipart 请求中分别通过 image=@input.png 与 mask=@mask.png 上传。不要把 URL 原图与本地蒙版文件混合传入;纯 URL 编辑请求不支持再附加本地 mask 文件。蒙版会约束编辑区域,但生成模型仍可能对边缘进行自然融合;需要严格边界时,应使用清晰的 Alpha 边缘并在提示词中重复说明哪些内容必须保持不变。
以上调用方式与 OpenAI Image Edit API 和 GPT Image 官方 Cookbook 的蒙版示例一致。
5. 常用参数
尺寸规则与生成接口一致:宽高须为 16 的倍数,长边不超过 3840,总像素为 655,360–8,294,400,宽高比不超过 3:1。省略
size 或使用 auto 时,模型会结合提示词和第一张参考图选择画幅。
gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst 与 gpt-image-2:reverse 按成功张数计费;gpt-image-2:official、gpt-image-2.5-flare:official 和 gpt-image-2.5-sunburst:official 根据文字输入、参考图输入和图片输出的实际 Token 结算,最终以使用记录为准。
6. 异步回调与排错
长任务可在请求中加入:{"task_id": "..."};完成后回调最终结果。同步请求则返回 created 和 data。
错误响应会包含
trace_id。反馈问题时提供该 ID,不要提供 API Key。
完整字段和实时枚举以 OpenAI Images Edits API 页面为准。纯文本生成图片请查看 GPT Image 2 / 2.5 图像生成。
