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 wide) | 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: "the car" }, { x:0.5, y:0.5 }
quality: 7
},
outputFileType: "jpeg" // 或 "png" 如果需要透明度
})
// result.outputUrl → 用于预览或链接
对焦指南:
"subject"— 默认;全身检测、风景、物体"face"— 肖像、头像"upper_body"— 胸部以上的裁剪{ prompt: "the logo" }— 来自用户表单输入的命名对象{ 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 展示板
预览后,使用块上传管道将每个输出上传到 CC 存储
(asset_initialize_file_upload → PUT 块 → asset_finalize_file_upload)。
然后使用最终输出 URL 调用 firefly 展示板工具:
create_firefly_board({
import_adobe_storage: [
final_output_url_1,
final_output_url_2,
// ...
]
})
✅ 已确认工作(Stage): 将
import_adobe_storage与来自asset_finalize_file_upload的预签名 URL 一起使用成功填充展示板。❌ 不起作用: 将
import_generic_assets与 CC 资产 ID(urn:aaid:sc:US:...)一起使用 — 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 存储 | 使用 filters.mediaType: "video/mp4" 的 asset_search → 使用资产 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是一个延迟工具 — 在尝试轮询之前先加载它。 直接调用将失败并显示“not loaded”错误。
video_resize({
assetId: videoAssetId,
width: targetW,
height: targetH,
mode: "letterbox" // 默认;请参阅下方的模式表
})
// 返回 { jobStatus: "pending", statusId }
模式 — 使用精确的 API 值(而非用户可见的标签):
| 用户说 | API 值 | 行为 |
|---|---|---|
| “fit”, “preserve ratio”, “letterbox” | "letterbox" | 保持比例,添加黑边(默认) |
| “fill”, “crop to fill”, “no bars” | "crop" | 裁剪边缘以精确填充目标 |
| “stretch”, “force exact” | "stretch" | 变形为精确目标 |
ℹ️ 视频的自动重构图在 Claude 中尚不可用,但是新工具正在不断添加。如果您需要更多控制,请尝试使用 Adobe Premiere。
轮询: 在调用延迟工具 resizeVideoPoll 之前先加载它 — 直接调用会失败并显示“not loaded”。
// 第 1 步:加载延迟工具