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 上传。

4. 常用参数

尺寸规则与生成接口一致:宽高须为 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 结算,最终以使用记录为准。

5. 异步回调与排错

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