Skip to main content

1. 获取 API Key

打开 Ace Data Cloud 应用列表,进入可用的应用并复制 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): GPT Image 2 生成的白色马克杯

3. 常用参数

常用尺寸: size: "auto" 会根据提示词中的比例、像素和版式意图选择画幅;需要精确像素时直接填写尺寸。

4. 多张生成

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. 异步回调

请求体加入 callback_url 后,接口会先返回 {"task_id": "..."},完成时向该 URL POST 最终结果;同步请求仍返回 createddata
回调接收方应使用 task_id 去重,并验证请求来源与数据格式。

6. 排错

错误响应会包含 error.codeerror.messagetrace_id。反馈问题时提供 trace_id,不要提供 API Key。 完整字段和实时枚举以 OpenAI Images Generations API 页面为准。图像编辑请查看 GPT Image 2 / 2.5 图像编辑