API 動作
上次更新時間
2024年9月30日
|
亦適用於 Adobe Firefly, Adobe Firefly for enterprise, Creative Cloud for enterprise
本文件將說明 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 呼叫 |
內容標記 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 呼叫。
