跳轉到主要內容

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" 會根據提示詞中的比例、像素和版面配置意圖選擇畫幅;需要精確像素時直接填寫尺寸。

模型與計費方式

官方 API 通道的頁面價格是請求前估算,最終以回應中的實際 Token 用量和使用紀錄為準。

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 圖像編輯。