AI 美化 API

Photoroom 的 AI 美化 API 可提升產品或美食照片中主體的品質，打造更美觀的視覺效果，從單張照片到整個產品目錄皆適用。

不同於一般圖像濾鏡，它提供專為你販售的商品打造的模式：ai.auto 可呈現美感產品棚拍照的風格，ai.food 適用於食物，ai.car 則適用於汽車。這是 Photoroom API 中 20 多種編輯功能之一。

Photoroom 的 AI 美化 API 可在你自己的上傳流程中完成這項工作：每張賣家照片一上傳就會自動美化，因此賣家不必改變拍攝或上傳方式。API 每次呼叫會處理一張圖片，而且可以平行執行多次呼叫，最高可達速率限制（預設每分鐘 60 張圖片，Enterprise 方案則更高）。

你也可以在同一次呼叫中，將它與定位、AI 陰影或 AI 背景結合使用。

對於食品影像，Photoroom 的 AI Beautifier API 提供專屬的食品模式。將 beautify.mode 設為 ai.food，即可獲得針對食品影像特性調整的結果，例如將主體放在盤子上。

外送平台和生鮮雜貨 App 可以透過它傳送整份菜單或產品目錄，每次呼叫處理一張圖片，並可同時發出多個呼叫，直到達到速率限制。

若要做到這點，請改用 Photoroom 的視覺品質檢測，而非 AI Beautifier：AI Beautifier 會改善照片，但不會為照片評分或篩選。視覺品質檢測適用於 Enterprise 方案，也可作為獨立的 API 產品購買。

Enterprise 方案可在 Visual Agents 工作流程中，結合視覺品質檢測、AI 美化工具及其他編輯功能。聯絡業務團隊以進行設定。

AI 美化工具包含在 Plus API 方案中，每月 100 美元（每張圖片 0.10 美元），也包含在 Enterprise 方案中。無論一次 API 呼叫合併哪些編輯，費用都相同，因此在一次呼叫中美化圖片並新增陰影，費用與單獨美化圖片相同；發生錯誤的呼叫則不會消耗圖片額度。

你可以先在沙盒模式中測試，每月可免費使用 1,000 次影像編輯 API 呼叫，結果會帶有浮水印。Enterprise 方案請洽詢業務。詳情請見價格頁面。

取得你的 API 金鑰，接著將 beautify.mode 設為 ai.auto，並傳送你的照片：

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header 'x-api-key: YOUR_API_KEY_HERE' \
  --form imageFile=@/path/to/image.png \
  --form beautify.mode=ai.auto \
  --output result-ai-beautifier.png

處理美食照片時，請使用 beautify.mode=ai.food。所有參數都列於 AI 美化工具說明文件中。

• beautify.mode（必填）：ai.auto適用於呈現美感商品棚拍照風格的結果，ai.food適用於食物圖片，或ai.car適用於汽車圖片，例如移除不需要的反光。

• beautify.seed（選填）：任意正整數。使用固定的 seed 時，API 會為同一張圖片產生外觀相似的美化主體。不指定 seed 時，每次呼叫都會產生不同結果。

AI 美化工具會重新詮釋主要主體的影像，因此可能會有所變動。請將結果與原始影像比較，並參閱 說明文件中的範例。

上傳 PNG、JPEG、WEBP 或 AVIF 檔案，大小上限為 30MB，最長邊最多 5,000 像素，即可取得相同格式的檔案。AI 美化工具預設會以 1K（1024x1024）解析度產生輸出；Enterprise 方案則提供 2K 和 4K 輸出解析度。詳情請參閱檔案大小、解析度與格式說明文件。

是的。Photoroom 提供 MCP 伺服器，供 Claude 等 AI 助理使用；如需了解其支援的工具，請參閱 Photoroom MCP。

若要將 AI 美化功能整合到自己的產品中，Claude Code 等 AI 程式碼代理能協助你快速整合 Photoroom API：你只要描述想要的成果，代理就會為你撰寫、執行並除錯程式碼。文件中提供了現成的提示。

使用 API 時遇到問題嗎？加入我們的 API 社群，向我們的工程師尋求協助，或查看 疑難排解頁面，了解常見問題。

任何與帳務相關或涉及敏感資訊的問題，請直接在社群中私訊 Photoroom。我們很樂意提供協助。