AI 影像編輯 API

影像編輯 API 只需一次請求，就能透過 AI 編輯產品照片。傳送圖片和你想進行的編輯項目，例如移除背景、AI 背景、陰影、重新打光、調整尺寸等。編輯後的圖片會直接回傳給你。此 API 專為電商團隊打造，無論是編輯一張照片還是整份產品目錄，都能輕鬆處理。

可以。一次 API 呼叫就能移除背景、加入 AI 陰影、設定留白、調整尺寸，並以你需要的格式匯出。你可以將每項編輯設為參數，讓同一次呼叫以相同方式處理產品目錄中的每張圖片。

從儀表板取得 API 金鑰，然後將圖片隨 POST 請求傳送。此範例會製作一張白色背景、帶有柔和陰影的產品展示圖：

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header "x-api-key: $PHOTOROOM_API_KEY" \
  --header "pr-ai-shadows-model-version: 2026-04-15" \
  --form imageFile=@/absolute/path/to/image.jpg \
  --form background.color=FFFFFF \
  --form padding=0.15 \
  --form shadow.mode=ai.auto-with-overrides \
  --form outputSize=1600x1600 \
  --form export.format=jpeg \
  --output result.jpg

你也可以在 API playground 中以視覺化方式設定 API 呼叫，並複製產生的程式碼。

可以，透過平行發送 API 呼叫即可。API 每次呼叫會編輯一張圖片，並立即傳回結果。若要處理產品目錄，可以透過工作池一次發送多個呼叫。預設上限為每分鐘 60 張圖片。Enterprise 方案可提高此上限，滿足大型產品目錄的需求。

影像編輯 API 是 Plus API 方案的一部分，每張圖片收費 $0.10。想免費測試，請使用 沙盒模式：在 API 金鑰開頭加上 sandbox_。你每月最多可免費呼叫 1,000 次，結果會帶有水印。查看 API 定價。

輸入：PNG、JPEG 或 WEBP，檔案大小上限為 30 MB，最長邊上限為 5,000 px。較大的圖片會自動縮小。輸出：預設為 PNG，也可選擇 JPEG、WEBP 或 AVIF。JPEG 無法保留透明度，因此匯出為 JPEG 時請設定背景顏色。詳情請參閱 API 文件。

可以。使用 GET 端點，並將圖片的公開 URL 作為 imageUrl 傳入。它接受的參數與 POST 端點相同。請使用 POST 處理本機檔案，使用 GET 處理已託管於線上的圖片。

每個回應都會附上不確定性分數（x-uncertainty-score），範圍從 0（有信心）到 1（不確定）。你可以根據分數自動標記需要審查的圖片。Enterprise 方案另提供視覺品質檢測，可依照你的品質標準為每個輸出評分；你只需為通過檢測的圖片付費。

是的。前往 Claude 中的設定 > 連接器 > 新增自訂連接器，使用 https://mcp.photoroom.com/mcp 連接 Claude 中的 Photoroom MCP。接著用一般英文提出編輯需求。此功能適用於 Claude 的付費方案，可在 Claude、Cowork 和 Claude Code 中使用；使用的點數與 API 相同，每個對話最多可編輯 20 張圖片。

查看 API 說明文件 和疑難排解頁面，或在 API 社群中向我們的工程師提問。若有帳單問題或任何敏感事項，請直接在社群中傳訊息給 Photoroom。