Communitygithub.com

Adobe 调整照片和视频大小

使用 Adobe 工具将照片和视频调整为精确的像素尺寸或宽高比。

Adobe 调整照片和视频大小 是什么?

此技能允许 AI 代理(例如 Claude Code、Cursor 或 Codex)利用 Adobe 的 API 将图像和视频文件精确调整为用户指定的尺寸、宽高比或命名大小。它支持常见需求,如将图像调整为 1920x1080、缩放至 4K、裁剪为正方形、更改视频宽高比为 16:9,以及为打印准备 A4 大小的文件。该技能区分图像和视频文件,并使用 `image_crop_and_resize` 进行照片处理,使用 `video_resize` 进行视频处理,同时提供多种缩放模式(例如 reframe、pad、extract)和智能对焦选项(例如主题、面部)。它还支持批量处理多个文件,将输出保存到 Creative Cloud,并创建 Firefly 展示板以便于查看。初始的 `adobe_mandatory_init` 调用对于建立工具上下文至关重要,并遵循结构化的多步摄入流程来收集用户参数。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/adobe/skills/tree/HEAD/plugins/creative-cloud/adobe-for-creativity/skills/adobe-resize-photos-and-videos

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Adobe 调整照片和视频大小 是做什么的?

将图像或视频调整为用户指定的尺寸、宽高比或命名大小。 对于社交媒体平台集(Instagram、TikTok 等)→ 请改用 adobe-create-social-variations 技能。


工具参考

步骤工具备注
打开文件选择器asset_add_file返回 presignedAssetUrl、assetId 和 mediaType
在 CC 中查找资产asset_search通过 asset_add_file 重新暂存图像结果;视频直接使用 id
渲染 PSD/AIdocument_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, 1920x1080width: 1920, height: 1080
4K3840 × 2160
HD, 1080p1920 × 1080
720p1280 × 720
480p854 × 480
A4 打印2480 × 3508 (300 DPI 纵向)
Letter 打印2550 × 3300 (300 DPI 纵向)
16:9, 1:1, 4:5, 9:16比率字符串 → 作为 output: "16:9" 传递
squareoutput: "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 步(图像)— 批量

如果表单中选择了批量模式或用户提供了多个文件:

  1. 为每个文件调用 asset_add_file() 以获取单独的预签名 URL
  2. 使用相同参数为每个文件调用 image_crop_and_resize
  3. 收集所有 outputUrl 值
  4. 在单次调用中使用所有输出调用 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 / UHD3840 × 2160
1080p / HD1920 × 1080
720p1280 × 720
480p854 × 480
纵向 9:161080 × 1920
方形 1:11080 × 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 步:加载延迟工具

相关技能