Adobe 調整照片與影片尺寸 是做什麼的?
將影像或影片調整為使用者指定的尺寸、長寬比或命名的大小。
如需社群媒體平台尺寸組(Instagram、TikTok 等)→ 請改用 adobe-create-social-variations 技能。
工具參考
| 步驟 | 工具 | 備註 |
|---|---|---|
| 開啟檔案挑選器 | asset_add_file | 回傳 presignedAssetUrl、assetId 和 mediaType |
| 在 CC 中尋找資產 | asset_search | 照片需透過 asset_add_file 重新暫存;影片可直接使用 id |
| 渲染 PSD/AI | document_render_vector | 調整大小前先轉換為 JPEG |
| 調整圖片大小 | image_crop_and_resize | 每個尺寸呼叫一次;預設為 reframe |
| 預覽輸出 | asset_preview_file | 所有輸出在一次呼叫中完成 |
| 上傳至 CC(開始) | asset_initialize_file_upload | 區塊上傳管線的第一次呼叫 |
| 上傳至 CC(完成) | asset_finalize_file_upload | 第二次呼叫;回傳用於展示板的預簽名 CC URL |
| 建立 Firefly 展示板 | create_firefly_board | 傳遞包含完成 URL 的 import_adobe_storage |
| 調整影片大小 | video_resize | 回傳用於輪詢的 statusId |
| 輪詢影片調整 | resizeVideoPoll | 延遲工具 — 呼叫前需先載入 |
工作流程
步驟 0 — 初始化 Adobe 工具
先呼叫 adobe_mandatory_init。這將回傳處理檔案規則和工具路由指南,為後續工作流程所需。
{ "skill_name": "adobe-resize-photos-and-videos", "skill_version": "1.1.0" }
步驟 1 — 權限檢查
既然 adobe_mandatory_init 已確認「Adobe for creativity」連接器已啟用,請交叉比對工具參考表格,檢查哪些工具可透過「Adobe for creativity」連接器使用。
立即執行動作
步驟 1: 如果參數遺失或不明確 → 執行多重步驟輸入(下方步驟 2)。
步驟 2: 如果尚未上傳檔案,請執行步驟 3(asset_add_file({}))。
步驟 3: 偵測圖片或影片,並路由到正確的工作流程(步驟 5 圖片/影片)。
步驟 2 — 多重步驟輸入
當使用者尚未提供完整參數(類型 + 尺寸 + 適合模式)時執行此操作。 如果使用者訊息已包含全部三者,則完全跳過。
使用 AskUserQuestion 逐步收集參數。
步驟 2a — 類型
AskUserQuestion([{
question: "照片還是影片?",
type: "single_select",
options: ["照片", "影片"]
}])
步驟 2b — 尺寸
如果是照片(multi_select — 使用者可選一個或多個):
AskUserQuestion([{
question: "尺寸 — 選取您需要的所有項目",
type: "multi_select",
options: [
"1080 × 1080 — Instagram 正方形",
"1080 × 1350 — Instagram 直式",
"1080 × 1920 — 限時動態 / Reels",
"1920 × 1080 — YouTube / 橫式",
"1280 × 720 — YouTube 縮圖",
"1200 × 675 — X / Twitter 貼文",
"1200 × 630 — Facebook / OG 圖片",
"1080 × 566 — LinkedIn 貼文",
"2560 × 1440 — YouTube 橫幅",
"3840 × 2160 — 4K / UHD",
"400 × 400 — 個人資料 / 大頭貼",
"2480 × 3508 — A4 列印(300 dpi)",
"自訂 — 我將輸入"
]
}])
如果使用者包含「自訂」→ 追問:「請輸入您的自訂尺寸(例如 1500×800):」
如果使用者選取多個預設 → 每個尺寸皆執行一次 image_crop_and_resize,
每次都使用相同的來源 URI 和參數。最後一起預覽所有輸出。
如果是影片(multi_select — 使用者可選一個或多個):
AskUserQuestion([{
question: "尺寸 — 選取您需要的所有項目",
type: "multi_select",
options: [
"1080 × 1920 — Reels / TikTok / 限時動態",
"1920 × 1080 — YouTube / 橫式",
"1080 × 1080 — 正方形貼文",
"1280 × 720 — YouTube 720p",
"3840 × 2160 — 4K / UHD",
"854 × 480 — SD / 480p",
"自訂 — 我將輸入"
]
}])
如果使用者選取多個影片預設 → 每個尺寸分別提交一個 video_resize 工作,
輪詢每個工作至完成,最後一起預覽所有輸出。
步驟 2c — 適合模式
如果是照片(single_select):
AskUserQuestion([{
question: "適合模式",
type: "single_select",
options: [
"Reframe — 裁剪以填滿",
"Pad — 信箱模式,不裁剪",
"Extract — 隔離主體"
]
}])
如果是影片(single_select):
AskUserQuestion([{
question: "適合模式",
type: "single_select",
options: [
"Letterbox — 維持比例",
"Crop — 填滿,無黑邊",
"Stretch — 強制精確(扭曲)"
]
}])
步驟 2d — 智慧焦點(僅限照片)
AskUserQuestion([{
question: "智慧焦點 — 裁剪應以哪裡為中心?",
type: "single_select",
options: [
"主體",
"臉部 / 人像",
"上半身",
"中心(幾何)",
"命名物件 — 我將描述"
]
}])
如果使用者選取「命名物件」→ 追問:「請描述該物件(例如『那輛紅車』、『標誌』):」
步驟 2e — 選項(僅限照片)
AskUserQuestion([{
question: "有任何其他選項嗎?",
type: "multi_select",
options: [
"批次 — 多張圖片",
"輸出:JPEG",
"輸出:PNG"
]
}])
步驟 2f — 來源(僅限影片)
AskUserQuestion([{
question: "影片位於何處?",
type: "single_select",
options: [
"從裝置上傳",
"從 Creative Cloud"
]
}])
步驟 3 — 取得來源檔案
關鍵 — /mnt/user-data/uploads/ 路徑不是可用的 URL。
即使使用者已附加檔案且該檔案在上下文中以 /mnt/user-data/uploads/ 路徑出現,
您也不能將此路徑傳遞給任何 Adobe 工具。請呼叫 asset_add_file() 來暫存檔案 — /mnt/user-data/uploads/ 路徑無法被 Adobe 工具擷取。
錯誤 ❌ imageURI: "/mnt/user-data/uploads/photo.jpg"
錯誤 ❌ imageURI: "file:///mnt/user-data/uploads/photo.jpg"
正確 ✅ 呼叫 asset_add_file() → 使用來自挑選器上下文的 presignedAssetUrl
尚無檔案 → 立即開啟挑選器:
asset_add_file()
從回傳的 mediaType 偵測類型:
image/*→ 圖片工作流程video/*→ 影片工作流程
步驟 4 — 解析目標尺寸
| 使用者說法 | 解析為 |
|---|---|
1920×1080, 1920x1080 | width: 1920, height: 1080 |
4K | 3840 × 2160 |
HD, 1080p | 1920 × 1080 |
720p | 1280 × 720 |
480p | 854 × 480 |
A4 列印 | 2480 × 3508(300 DPI 直式) |
Letter 列印 | 2550 × 3300(300 DPI 直式) |
16:9, 1:1, 4:5, 9:16 | 比例字串 → 傳遞為 output: "16:9" |
square | output: "1:1" |
僅寬度(800px 寬) | width: 800,使用比例字串維持外觀比例 |
如果表單中未指定目標,且使用者訊息中也沒有 → 詢問:
「您需要什麼尺寸?(例如 1920×1080、A4、16:9)」
圖片工作流程
步驟 5(圖片)— 有效的 URI 來源
只有以下項目可作為 imageURI:
- 來自
asset_add_file()的presignedAssetUrl✅ - 來自先前工具呼叫的
outputUrl✅ - 使用者提供的公開 HTTPS URL ✅
不可用作 imageURI:
/mnt/user-data/uploads/路徑 ❌- 直接來自
asset_search的renditionURL❌ file://URI ❌
| 來源 | 解決方式 |
|---|---|
| 上傳的檔案 | asset_add_file() → presignedAssetUrl |
| CC 儲存空間資產 | asset_search → 透過 asset_add_file() 重新暫存 → presignedAssetUrl |
| 先前工具輸出 | 直接使用 outputUrl |
| PSD / AI 檔案 | document_render_vector(JPEG、300 DPI)→ outputPresignedUrl |
步驟 6(圖片)— 適合模式
| 意圖 | 模式 | 備註 |
|---|---|---|
| "調整為 WxH" / 預設 | reframe | 在目標比例下最大的裁剪區域,居中 — 無失真 |
| "不裁剪", "信箱模式", "適合在內部" | pad | 以白色填滿空白區域 |
| "隔離主體", "緊密裁剪" | extract | 圍繞偵測區域進行緊密裁剪 |
預設:reframe。 僅在使用者明確指定時才變更。
⛔
fit: "extract"與明確的{ width, height }不相容 — 它會拉伸圖片。請使用比例字串或省略output。
步驟 7(圖片)— 呼叫 image_crop_and_resize
image_crop_and_resize({
imageURI: presignedAssetUrl,
options: {
output: { width: 1920, height: 1080 }, // 或 "16:9"
fit: "reframe",
focus: "subject", // 或 "face", "upper_body", { prompt: "那輛車" }, { x:0.5, y:0.5 }
quality: 7
},
outputFileType: "jpeg" // 或 "png"(如果需要透明度)
})
// result.outputUrl → 用於預覽或串聯
焦點指引:
"subject"— 預設;全身偵測、風景、物體"face"— 人像、頭像"upper_body"— 胸部以上裁剪{ prompt: "標誌" }— 來自使用者表單輸入的命名物件{ x: 0.5, y: 0.5 }— 幾何中心(無明確主體)
步驟 8(圖片)— 批次
如果表單中選取了批次,或者使用者提供了多個檔案:
- 為每個檔案呼叫
asset_add_file()以取得個別預簽名 URL - 使用相同參數為每個檔案呼叫
image_crop_and_resize - 收集所有
outputUrl值 - 在一次呼叫中使用所有輸出呼叫
asset_preview_file
在此環境中呼叫會依序執行。若超過 10 張圖片,請在開始前與使用者確認。
跨回合分頁(批次 > 20): 對於大型批次,對話上下文可能會在所有圖片處理完成前填滿, 導致 Claude 在批次中途暫停。這是預期行為 — 不是錯誤。發生時:
- 說明已完成多少張以及剩餘多少張(例如「20 / 24 完成 — 說『繼續』以處理剩餘部分」)
- 等待使用者確認後再繼續
- 繼續時,從下一張未處理的圖片開始,持續處理到結束
- 僅在最後一張圖片完成後,才一起預覽所有輸出
步驟 9(圖片)— 預覽 + 交付 + Firefly 展示板
asset_preview_file({
assets: [
{ name: "photo_1920x1080.jpg", presignedAssetUrl: result.outputUrl },
// 所有成功的輸出
]
})
儲存至 CC 並建立 Firefly 展示板
預覽後,使用區塊上傳管線(asset_initialize_file_upload → PUT 區塊 → asset_finalize_file_upload)將每個輸出上傳至 CC 儲存空間。
接著使用最終輸出 URL 呼叫 firefly 展示板工具:
create_firefly_board({
import_adobe_storage: [
final_output_url_1,
final_output_url_2,
// ...
]
})
✅ 已確認可運作(Stage): 使用來自
asset_finalize_file_upload的預簽名 URL 的import_adobe_storage成功填入展示板。❌ 不可運作: 使用 CC 資產 ID(
urn:aaid:sc:US:...)的import_generic_assets— USS 索引延遲會導致空白展示板。如果展示板建立失敗或 URL 格式錯誤,請省略展示板連結(重試也無幫助)。
在展示板步驟後張貼完成摘要:
✅ 完成!已調整 [N] 張圖片的尺寸並就緒。
📥 下載:
• resized_1920x1080.jpg → <cc_storage_url>
[若 N ≤ 3,則個別列出;若 N > 3,則提供單一資料夾連結]
🎨 在 Firefly 展示板中檢視 → <board_url> ← 若展示板建立失敗則省略
影片工作流程
步驟 5(影片)— 取得資產 ID
影片工具需要 assetId,而非 URL。
| 來源 | 如何處理 |
|---|---|
透過 asset_add_file 上傳 | 使用回傳的 assetId |
| CC 儲存空間 | asset_search 搭配 filters.mediaType: "video/mp4" → 使用資產 id |
步驟 6(影片)— 常見目標
| 名稱 | 尺寸 |
|---|---|
| 4K / UHD | 3840 × 2160 |
| 1080p / HD | 1920 × 1080 |
| 720p | 1280 × 720 |
| 480p | 854 × 480 |
| 直式 9:16 | 1080 × 1920 |
| 正方形 1:1 | 1080 × 1080 |
步驟 7(影片)— 呼叫 video_resize
⚠️
resizeVideoPoll是延遲工具 — 在嘗試輪詢前需先載入。 在未載入的情況下直接呼叫會失敗並顯示「未載入」錯誤。
video_resize({
assetId: videoAssetId,
width: targetW,
height: targetH,
mode: "letterbox" // 預設;請參閱下方模式表格
})
// 回傳 { jobStatus: "pending", statusId }
模式 — 使用確切的 API 值(非使用者面向標籤):
| 使用者說法 | API 值 | 行為 |
|---|---|---|
| "適合", "維持比例", "信箱模式" | "letterbox" | 維持比例,加入黑邊(預設) |
| "填滿", "裁剪以填滿", "無黑邊" | "crop" | 裁剪邊緣以精確填滿目標 |
| "拉伸", "強制精確" | "stretch" | 扭曲以符合精確目標 |
ℹ️ 影片的自動重構圖功能在 Claude 中尚不可用,但新工具一直在新增。如果您需要更多控制,請嘗試使用 Adobe Premiere。
輪詢: 在呼叫 resizeVideoPoll 之前先載入延遲工具 — 直接呼叫會失敗並顯示「未載入」。
// 步驟 1:載入延遲工具
// (實際載入方法取決於環境,請參考平台特定文件)
// 步驟 2:輪詢狀態
resizeVideoPoll({ statusId: previousStatusId })
// 回傳 { status: "done", outputAssetId: "..." } 或 { status: "in_progress" }
持續輪詢直到
status為"done"。如果status為"failed",請告知使用者失敗並停止。
步驟 8(影片)— 預覽 + 交付 + Firefly 展示板
asset_preview_file({
assets: [
{
name: "video_1920x1080.mp4",
assetId: "video_output_asset_id"
}
]
})
儲存至 CC + 建立 Firefly 展示板
對於影片,create_firefly_board 使用的 import_adobe_storage 需要 assetId,而非預簽名 URL。如果在步驟 5 中使用了 asset_add_file,請使用原始上傳的 assetId。
create_firefly_board({
import_adobe_storage: [
"video_output_asset_id"
]
})
如果展示板建立失敗,請省略展示板連結。
步驟 9(影片)— 完成
✅ 完成!已調整 [N] 部影片的尺寸並就緒。
📥 下載:
• resized_1920x1080.mp4 → <cc_storage_url>
🎨 在 Firefly 展示板中檢視 → <board_url> ← 若展示板建立失敗則省略
常見邊緣案例
| 情境 | 處理方式 |
|---|---|
| 使用者說「使其適合 16:9」 | 使用 output: "16:9" 呼叫 image_crop_and_resize,搭配預設的 reframe |
| 使用者說「需要相同尺寸的多份拷貝」 | 為每個拷貝使用相同參數重複呼叫 image_crop_and_resize / video_resize |
| 單一請求中包含圖片和影片 | 先處理所有圖片,然後處理所有影片 — 不要混合 |
使用者附加了 .heic 檔案 | 由 asset_add_file 處理;轉換會自動發生 |
| 使用者詢問「哪種尺寸效果最好」 | 引導他們使用步驟 2 中的預設,或解釋目標平台(YouTube、Instagram 等) |
image_crop_and_resize 回傳錯誤 | 檢查 imageURI 是否有效(不是 /mnt/user-data/uploads/ 路徑)並重試 |
video_resize 回傳錯誤 | 確認 assetId 有效且影片格式為 video/mp4 |