1. 取得 API Key
開啟 Ace Data Cloud 應用程式列表,進入可用的應用程式並複製 API Key。
2. 使用圖片 URL 編輯
原圖:
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 圖片不能作為有效遮罩;
- 提示詞應描述期望得到的完整畫面,同時明確局部修改和需要保持不變的內容。
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. 非同步回呼與除錯
長任務可在請求中加入:{"task_id": "..."};完成後回呼最終結果。同步請求則回傳 created 和 data。
錯誤回應會包含
trace_id。回報問題時提供該 ID,不要提供 API Key。
完整欄位和即時列舉以 OpenAI Images Edits API 頁面為準。純文字生成圖片請查看 GPT Image 2 / 2.5 圖像生成。
