跳轉到主要內容

1. 取得 API Key

開啟 Ace Data Cloud 應用程式列表,進入可用的應用程式並複製 API Key。 取得 Ace Data Cloud API Key

2. 使用圖片 URL 編輯

原圖: GPT Image 2 編輯原圖
成功回應:
這是 2026 年 9 月 8 日透過 Ace Data Cloud 實際完成的編輯結果,杯子變為橙色、背景變為深海軍藍,並保持原始構圖和 1024×1536 尺寸: GPT Image 2 橙色馬克杯編輯結果

3. 上傳本機圖片

使用 multipart/form-data:
可重複傳入 image,GPT Image 系列最多支援 16 張參考圖。JSON 請求中的 image 可以是單一 URL 或 URL 陣列;本機檔案使用 multipart 上傳。

模型與計費方式

官方 API 通道的頁面價格為請求前預估,最終以回應中的實際 Token 用量和使用紀錄為準。 quality 支援 auto、low、medium、high;僅 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst(含 :official 變體)額外支援 xhigh、max。JSON 圖片 URL 編輯和 multipart 檔案編輯皆可傳入該欄位;官方通道依實際 Token 用量計費。

4. 使用遮罩進行局部編輯

官方 Images Edit 介面透過 mask 指定允許修改的區域。Ace Data Cloud 的 :official 模型遵循相同的 multipart 契約:
  • mask 必須是帶有 Alpha 通道的 PNG,大小不得超過 4MB;
  • 遮罩尺寸必須與第一張 image 完全一致;
  • Alpha 為 0 的透明像素表示允許編輯,非透明像素表示應保留;
  • 只有顏色為黑白、但沒有透明通道的 RGB 圖片不能作為有效遮罩;
  • 提示詞應描述期望得到的完整畫面,同時明確局部修改和需要保持不變的內容。
以下先從原圖生成一個遮罩。範例將中央矩形設為透明,只允許模型修改該區域:
接著把原圖和遮罩一起上傳:
也可以沿用 OpenAI 官方 Python SDK 的 images.edit 呼叫方式,只需將 base_url 指向 Ace Data Cloud:
使用 mask 時,原圖和遮罩必須在同一個 multipart 請求中分別透過 image=@input.png 與 mask=@mask.png 上傳。不要將 URL 原圖與本機遮罩檔案混合傳入;純 URL 編輯請求不支援再附加本機 mask 檔案。遮罩會約束編輯區域,但生成模型仍可能對邊緣進行自然融合;需要嚴格邊界時,應使用清晰的 Alpha 邊緣並在提示詞中重複說明哪些內容必須保持不變。 以上呼叫方式與 OpenAI Image Edit API 和 GPT Image 官方 Cookbook 的遮罩範例一致。

5. 常用參數

尺寸規則與生成介面一致:寬高須為 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 結算,最終以使用記錄為準。

6. 非同步回呼與除錯

長任務可在請求中加入:
非同步 200 回應為 {"task_id": "..."};完成後回呼最終結果。同步請求則回傳 created 和 data。 錯誤回應會包含 trace_id。回報問題時提供該 ID,不要提供 API Key。 完整欄位和即時列舉以 OpenAI Images Edits API 頁面為準。純文字生成圖片請查看 GPT Image 2 / 2.5 圖像生成。