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