API 動作
上次更新時間
2025年7月15日
適用於企業。
本頁說明 Firefly Services API 和 Firefly Creative Production 操作的功能，以及如何為每個操作定義操作。
Firefly Services
Firefly APIs*
| API 動作 | 功能 | 狀況 | 操作定義 |
|---|---|---|---|
| 以文字建立影像 | 根據文字提示生成影像 | 1 次操作 = 從 Firefly 基礎模型或自訂模型產生 1 張影像 | |
| 使用結構參考功能，以文字建立影像 | 根據提示和 (選擇性) 參考影像來產生影像，以符合其結構 | 1 次操作 = 從 Firefly 基礎模型或自訂模型產生 1 張影像 | |
| 使用樣式參考功能，以文字建立影像 | 根據提示產生影像，並有參考影像 (選項) 可搭配風格 | 1 次操作 = 從 Firefly 基礎模型或自訂模型產生 1 張影像 | |
| 生成式填色 | 使用可選的提示填滿影像的遮罩區域 | 1 次操作 = 1 個使用基礎 Firefly 模式生成的影像 | |
| 生成式擴張 | 將影像擴張為新的尺寸/長寬比 | 1 次操作 = 1 個使用基礎 Firefly 模式生成的影像 | |
| 產生類似影像 | 根據參考影像產生類似影像 | 1 次操作 = 1 個使用基礎 Firefly 模式生成的影像 | |
| 產生物件合成 | 上傳影像 (有或沒有遮色片)，例如產品照片，並利用文字提示產生以產品為特色的無縫合成場景 | 1 次操作 = 1 個使用基礎 Firefly 模式生成的影像 | |
| 產生影片 | 從文字提示、參考影像或兩者的組合產生逼真或動畫影片剪輯。 | 影片模型 1，540p 解析度 | 0.4 次操作 = 1 秒產生的影片 |
| 影片模型 1，720p 解析度 | 1 次操作 = 1 秒產生的影片 | ||
| 影片模型 1，1080p 解析度 | 2 次操作 = 1 秒產生的影片 |
* Firefly API 包含允許每次 API 呼叫產生多張影像的參數。
Photoshop API
|
|
功能 |
操作定義 |
|---|---|---|
|
移除背景 |
隔離影像中相關主體並刪除背景 |
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 動作 |
功能 |
操作定義 |
|---|---|---|
|
拉直影像 |
自動拉直影像 |
1 次操作 = 1 次 API 呼叫 |
|
自動色調 |
將自動色調套用於影像 |
1 次操作 = 1 次 API 呼叫 |
|
編輯影像 |
對相片進行 Lr 調整，包括曝光、對比、細節等。 |
1 次操作 = 1 次 API 呼叫 |
|
套用預設集 |
將 Lr 預設集套用於相片 |
1 次操作 = 1 次 API 呼叫 |
|
套用 XMP |
新增 XMP 中繼資料至相片 |
1 次操作 = 1 次 API 呼叫 |
InDesign API
|
API 動作 |
功能 |
操作定義 |
|---|---|---|
|
資料合併 |
利用 InDesign 標記文件和 CSV 檔案中的變數欄位產生多個資產變化版本 |
1 次操作 = 1 個輸出頁面 |
|
轉譯 |
從 InDesign 文件建立 JPEG、PNG 或 PDF |
1 次操作 = 1 個輸出頁面 |
|
自訂指令碼 |
使用 InDesign 功能建立和執行自訂指令碼 |
1 個操作 = 1 個輸出*或輸入頁面，以較高者為準 *輸出包括任何透過「儲存」、「另存新檔」或「儲存副本」儲存的檔案，以及任何透過「匯出」建立的檔案。 |
視訊和音訊 API
|
API 動作 |
功能 |
操作定義 |
|---|---|---|
|
重構 |
識別影片中的動作並重新構圖剪輯，以適應不同的長寬比 |
|
|
以文字建立顯示圖片 |
將文字指令碼轉換為具有逼真的虛擬人偶的視訊，並提供各種預先拍攝的虛擬人偶選擇和自然的聲音 |
1 次操作 = 5 秒的輸出影片 |
|
文字轉語音 |
將書面文字轉換為口說語音，使企業能夠建立動態音訊 |
1 次操作 = 10 分鐘的輸出語音 |
視訊和音訊 API、附加元件
| API 動作 | 功能 | 操作定義 |
|---|---|---|
| 轉錄 | 為音訊和視訊內容產生原始語言或翻譯語言的文字記錄和字幕 | 1 次操作 = 10 分鐘的輸入影片或音訊 |
| 配音 | 透過可選的唇形同步功能自動進行音訊和影片語音翻譯，不管背景噪音和音樂如何，仍能產生高品質的配音輸出 | 無唇形同步：1 次操作 = 10 秒輸出視訊或音訊 |
| 帶唇形同步：1 次操作 = 5 秒輸出視訊 |
內容標記 API
|
API 動作 |
功能 |
操作定義 |
|---|---|---|
|
顏色標記 |
假設是一個影像，可以計算像素顏色長條圖，並按主色將像素顏色排序至桶中 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
關鍵字標記 |
假設是文字文件，關鍵字標記服務會自動提取最能描述文件主題的關鍵字或關鍵詞 |
1 次操作 = 每個資產 1 次 API 呼叫 |
|
OCR |
假設是一個影像，可以指示影像中是否要出現文字。 如果要出現文字，OCR 可以返回文字 |
1 次操作 = 每個資產 1 次 API 呼叫 |
Substance 3D APIs
| API 動作 | 功能 | 狀況 | 操作定義 |
|---|---|---|---|
| 產生 3D 物件合成 API** | 將 3D 物件無縫合成到 Firefly 產生的 2D 場景中，以建立像素完美的保真合成，具有逼真的燈光、陰影和紋理 | Firefly 影像模型 4：最長邊小於或等於 2000 像素 | 2 次操作 = 1 張輸出影像 (或變體) |
Firefly 影像模型 4：最長邊大於 2000 像素 |
3 次操作 = 1 張輸出影像 (或變體) |
||
Firefly 影像模型 4 Ultra：最長邊小於或等於 2000 像素 |
3 次操作 = 1 張輸出影像 (或變體) |
||
Firefly 影像模型 4 Ultra：最長邊大於 2000 像素 |
4 次操作 = 1 張輸出影像 (或變體) |
||
| 轉譯 3D 物件 API** | 透過自動建立具有精確照明、陰影和反射的逼真包裝照片，大規模轉譯像素完美的產品包裝照片 | 最長邊小於或等於 2000 像素 | 1 次操作 = 1 個輸出影像 |
最長邊大於 2000 像素 |
2 次操作 = 1 個輸出影像 |
||
| 建立 3D 場景 API | 將多個 3D 資產合併為一個具有凝聚力和細節的場景，用於承載數位孿生 | 1 次操作 = 1 個輸出檔案 | |
| 轉換 3D 檔案 API | 將 FBX 和 OBJ 等格式的現有 3D 內容轉換為更通用的檔案格式，如 gITF 和 USD | 1 次操作 = 1 個輸出檔案 | |
| 說明 3D 場景 API | 產生有關 3D 場景內容的詳細統計資料 | 免費 |
** 產生 3D 物件合成 API 和轉譯 3D 物件 API 包含允許每次 API 呼叫產生多個影像的參數。
Firefly Creative Production
|
動作 |
功能 |
操作定義 |
|---|---|---|
|
移除背景（平面影像輸出） |
隔離影像中感興趣的主題，移除背景，並輸出平面影像檔案 |
1 次操作 = 1 個輸出檔案 |
|
裁切 |
裁切影像尺寸或長寬比 |
2 次操作 = 1 個輸出檔案 |
|
調色 |
自動調整色調或將 Lightroom 預設集套用在批次上傳的影像上 |
1 次操作 = 1 個輸出檔案 |
