API 動作
上次更新時間
2025年5月12日
適用於企業。
本文件將說明 Firefly、Photoshop、Lightroom、視訊和音訊和內容標記 (由 Sensei 平台提供支援) 等可用的 API 和功能，這些是 Firefly 提供服務的一部份。
Firefly API
|
|
功能 |
操作定義 (1) |
|---|---|---|
|
以文字建立影像 |
根據文字提示生成影像 |
1 次操作 = 1 個使用基礎 Firefly 模式生成的標準影像 |
|
生成式填色 |
使用可選的提示填滿影像的遮罩區域 |
1 次操作 = 1 個使用基礎 Firefly 模式生成的標準影像 |
|
生成式擴張 |
將影像擴張為新的尺寸/長寬比 |
1 次操作 = 1 個使用基礎 Firefly 模式生成的標準影像 |
|
使用樣式參考功能，以文字建立影像 |
根據提示產生影像，並有參考影像 (選項) 可搭配風格 |
1 次操作 = 1 個使用基礎 Firefly 模式生成的標準影像 |
|
使用結構參考功能，以文字建立影像 |
根據提示和 (選擇性) 參考影像來產生影像，以符合其結構。 |
1 次操作 = 1 個使用基礎 Firefly 模式生成的標準影像 |
|
產生類似影像 |
根據參考影像產生類似影像。 |
1 次操作 = 1 個使用基礎 Firefly 模式生成的標準影像 |
|
產生物件合成 |
上傳影像 (有或沒有遮色片)，例如產品照片，並利用文字提示產生以產品為特色的無縫合成場景。 |
1 次操作 = 1 個使用基礎 Firefly 模式生成的標準影像 |
(1) 標準影像是指寬度不超過 2000 x 2000 像素的影像。 API 請求可能會導致生成多個影像。 價格不含使用「自訂模式擴充功能」生成影像的任何未來功能。
檔案大小限制
對於用來生成式填色、生成式擴張或生成式符合的影像資產，每次成功的 API 呼叫檔案大小限制最多為 15 百萬位元組 (或 MB)。
Creative Cloud API
Photoshop API
|
API 動作 |
功能 |
操作定義 (2) |
|---|---|---|
|
移除背景 |
隔離影像中相關主體並刪除背景 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
建立遮罩 |
隔離影像中相關主體 (人、物件等) 並生成影像遮罩 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
建立轉譯 |
建立 PSD 格式的平面影像呈現 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
建立 actionJSON |
將 .atn 檔案轉換為 actionJSON 格式 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
執行 actionJSON |
使用 actionJSON 格式執行 Photoshop 動作 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
執行 Photoshop 動作 |
以 PSD、JPEG、PNG 或 TIFF 執行 Photoshop 動作檔案 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
取代智慧式物件 |
取代 PSD 中的智慧式物件 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
產品裁切 |
智慧式裁切影像，保持感興趣的主題清晰可見 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
深度模糊 |
將深度模糊套用於影像輸入 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
編輯文字圖層 |
變更 PSD 中的文字圖層內容，例如用於本地化 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
套用 PSD 編輯 |
套用基本圖層編輯 (名稱、狀態等)、新增/編輯調整、像素和形狀圖層 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
建立全新 PSD... |
建立帶有圖層的全新 PSD |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
建立工作畫板 |
從多個 PSD 輸入來建立工作畫板 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
取得資訊清單 |
從 PSD 文件擷取中繼資料，包括一般檔案和圖層資訊 |
1 次操作 = 每個資產 1 次 API 呼叫 |
Lightroom API
|
API 動作 |
功能 |
操作定義 (2) |
|---|---|---|
|
拉直影像 |
自動拉直影像 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
自動色調 |
將自動色調套用於影像 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
編輯影像 |
對相片進行 Lr 調整，包括曝光、對比、細節等。 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
套用預設集 |
將 Lr 預設集套用於相片 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
套用 XMP |
新增 XMP 中繼資料至相片 |
1 次操作 = 每個資產 1 次 API 呼叫 |
InDesign API
|
API 動作 |
功能 |
操作定義 (2) |
|---|---|---|
|
資料合併 |
利用 InDesign 標記文件和 CSV 檔案中的變數欄位產生多個資產變化版本。 |
1 次操作 = 1 個輸出頁面 |
|
轉譯 |
從 InDesign 文件建立 JPEG、PNG 或 PDF。 |
1 次操作 = 1 個輸出頁面 |
|
自訂指令碼 |
使用 InDesign 功能建立和執行自訂指令碼。 |
1 個操作 = 1 個輸出*或輸入頁面，以較高者為準 *輸出包括任何透過「儲存」、「另存新檔」或「儲存副本」儲存的檔案，以及任何透過「匯出」建立的檔案。 |
視訊和音訊 API
|
API 動作 |
功能 |
操作定義 (2) |
|---|---|---|
|
重構 |
識別影片中的動作並重新構圖剪輯，以適應不同的長寬比。 |
|
|
以文字建立顯示圖片 |
將文字指令碼轉換成包含逼真顯示圖片的影片，並提供多種預先拍攝的顯示圖片選擇 |
1 次操作 = 5 秒的輸出影片 |
|
文字轉語音 |
將書面文字轉換為口說語音，使企業能夠建立動態音訊；與「以文字建立顯示圖片」搭配使用 |
1 次操作 = 10 分鐘的輸出影片 |
視訊和音訊 API、附加元件
|
API 動作 |
功能 |
操作定義 (2) |
|---|---|---|
|
翻譯音訊 |
透過可選的對嘴功能自動進行音訊和影片語音翻譯，不管背景噪音和音樂如何，仍能產生高品質的配音輸出。 |
1 次操作 = 10 秒的輸出影片 |
|
對嘴 |
透過說話者嘴部準確的唇型構圖實現精確的對嘴，並製作高品質的合成對嘴影片。 |
1 次操作 = 5 秒的輸出影片 |
內容標記 API
|
API 動作 |
功能 |
操作定義 (2) |
|---|---|---|
|
顏色標記 |
假設是一個影像，可以計算像素顏色長條圖，並按主色將像素顏色排序至桶中 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
關鍵字標記 |
假設是文字文件，關鍵字標記服務會自動提取最能描述文件主題的關鍵字或關鍵詞 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
OCR |
假設是一個影像，可以指示影像中是否要出現文字。 如果要出現文字，OCR 可以返回文字 |
1 次操作 = 每個資產 1 次 API 呼叫 |
(2) API 動作可以針對多個資產執行。 例如，如果客戶要求對一百 (100) 項資產執行 API 動作，則此類 API 動作將被計算為一百 (100) 項操作。 為清楚起見，狀態輪詢 API 動作不會用掉操作次數。
檔案大小限制
若是影像資產 (例如，PSD 和 PNG 檔案)，每次成功的 API 呼叫的 Creative Cloud API 檔案大小限制最多為 300 百萬位元組 (或 MB)。
當客戶使用 Photoshop 和 Lightroom API 時，每次成功的 API 資產呼叫的檔案大小僅限於為每種資產類型所訂的每次成功 API 呼叫檔案大小限制。 如果客戶每次成功的 API 呼叫超出檔案大小限制，則客戶必需為額外的成功 API 呼叫付費。
例如，200 MB PSD 檔案將計為一次成功的 API 呼叫，500 MB PSD 檔案將計為兩次成功的 MB 呼叫，而 700 MB PSD 檔案計為三次成功 API 呼叫。
其他
Firefly 創意製作
|
API 動作 |
功能 |
操作定義 |
|---|---|---|
|
移除背景（平面影像輸出） |
隔離影像中感興趣的主題，移除背景，並輸出平面影像檔案 |
1 次操作 = 1 個輸出檔案 |
|
移除背景 (分層的 PSD 輸出) |
隔離影像中感興趣的主題，移除背景，並輸出分層的 PSD 檔案 |
3 次操作 = 1 個輸出檔案 |
|
裁切 |
裁切影像尺寸或長寬比 |
2 次操作 = 1 個輸出檔案 |
|
調色 |
自動調整色調或將 Lightroom 預設集套用在批次上傳的影像上 |
1 次操作 = 1 個輸出檔案 |
