1. 获取 API Key
打开 Ace Data Cloud 应用列表,进入可用的应用并复制 API Key。
2. 发送第一个请求
data[].url。下面是 2026 年 9 月 8 日通过 Ace Data Cloud 实际请求得到的 1024×1536 结果(任务 d56455e2-e7f7-4bcd-b935-475b0a1e0948,trace eb938601-8192-407f-b539-1e0554b697ec):
3. 常用参数
常用尺寸:
size: "auto" 会根据提示词中的比例、像素和版式意图选择画幅;需要精确像素时直接填写尺寸。
4. 多张生成
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. 异步回调
请求体加入callback_url 后,接口会先返回 {"task_id": "..."},完成时向该 URL POST 最终结果;同步请求仍返回 created 和 data:
task_id 去重,并验证请求来源与数据格式。
6. 排错
错误响应会包含
error.code、error.message 和 trace_id。反馈问题时提供 trace_id,不要提供 API Key。
完整字段和实时枚举以 OpenAI Images Generations API 页面为准。图像编辑请查看 GPT Image 2 / 2.5 图像编辑。
