1. 获取 API Key
打开 Ace Data Cloud 应用列表,进入可用的应用并复制 API Key。
2. 使用图片 URL 编辑
原图:
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-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 结算,最终以使用记录为准。
5. 异步回调与排错
长任务可在请求中加入:{"task_id": "..."};完成后回调最终结果。同步请求则返回 created 和 data。
错误响应会包含
trace_id。反馈问题时提供该 ID,不要提供 API Key。
完整字段和实时枚举以 OpenAI Images Edits API 页面为准。纯文本生成图片请查看 GPT Image 2 / 2.5 图像生成。
