adobe-edit-quick-cut
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAdobe Edit Quick Cut
Adobe Edit Quick Cut
Produces 3 AI-edited sizzle reel variations from a source video, all at the same duration and
style — giving the user options to pick from.
从源视频生成3个AI编辑的高光剪辑变体,所有变体时长和风格一致,供用户选择。
Tool Reference
工具参考
| Step | Tool | Notes |
|---|---|---|
| Upload source video | | File picker; returns CC asset URN required by Quick Cut |
| Run Quick Cut variations | | Fire 3 in parallel; same duration and style prompt |
| Poll job status | | Repeat until all 3 return |
| Preview variations | | Renders all 3 side-by-side for selection |
| Resize re-uploaded output | | Workaround only — Quick Cut output must be re-uploaded first |
| 步骤 | 工具 | 说明 |
|---|---|---|
| 上传源视频 | | 文件选择器;返回Quick Cut所需的CC资产URN |
| 生成Quick Cut变体 | | 并行生成3个变体;使用相同时长和风格提示 |
| 轮询任务状态 | | 重复轮询直到3个任务均返回 |
| 预览变体 | | 将3个变体并排渲染以供选择 |
| 调整重新上传的输出尺寸 | | 仅作为临时解决方案——需先重新上传Quick Cut的输出文件 |
Quickstart
快速开始
Step 1: Verify entitlement and available tools.
Step 2: Call to open the file picker.
Step 3: Confirm upload, then present the Q&A form.
Step 4: Run 3 Quick Cut variations in parallel. Preview all 3. Allow download.
asset_add_file({})步骤1: 验证权限和可用工具。
步骤2: 调用打开文件选择器。
步骤3: 确认上传完成,然后展示问答表单。
步骤4: 并行生成3个Quick Cut变体。预览所有变体并允许下载。
asset_add_file({})Workflow
工作流
Step 0 — Initialize Adobe Tools
步骤0 — 初始化Adobe工具
Call first. This returns file handling rules and tool routing guidance required for the rest of the workflow.
adobe_mandatory_initjson
{ "skill_name": "adobe-edit-quick-cut", "skill_version": "1.0.1" }首先调用。此接口会返回文件处理规则和工具路由指引,为后续工作流提供必要支持。
adobe_mandatory_initjson
{ "skill_name": "adobe-edit-quick-cut", "skill_version": "1.0.1" }Step 1 — Entitlement Check
步骤1 — 权限检查
Now that confirmed that the "Adobe for creativity" connector is live, check which tools are available through the "Adobe for creativity" connector by cross checking against the Tool Reference table above.
adobe_mandatory_init在确认“Adobe创意工具”连接器已激活后,通过对照上方的工具参考表,检查该连接器下可用的工具。
adobe_mandatory_initStep 2 — Open the File Picker
步骤2 — 打开文件选择器
Open the picker immediately with this message:
"Let's create a punchy sizzle reel from your video. Start by selecting your file:"
javascript
asset_add_file()Once the user selects a file, extract (CC asset URN) from widget context.
assetIdrequires a CC asset URN (video_create_quick_cut), notassetId.presignedAssetUrl
立即使用以下提示打开文件选择器:
"让我们从你的视频中制作引人注目的高光剪辑。请先选择你的文件:"
javascript
asset_add_file()用户选择文件后,从组件上下文提取(CC资产URN)。
assetId需要CC资产URN(video_create_quick_cut),而非assetId。presignedAssetUrl
Step 3 — Confirm Upload
步骤3 — 确认上传
Once the file is selected, confirm with:
"Got it — [filename] is ready. Now let's set up your cut."
Then immediately present the Q&A form below.
文件选择完成后,使用以下内容确认:
"已收到——[文件名]准备就绪。现在让我们设置剪辑参数。"
随后立即展示下方的问答表单。
Step 4 — Q&A Form (via AskUserQuestion)
步骤4 — 问答表单(通过AskUserQuestion)
Wait for the user's answers before proceeding; present the questions via AskUserQuestion
(not plain text) so the user gets tappable buttons.
javascript
AskUserQuestion({
questions: [
{
header: "Cut Length",
question: "What kind of cut would you like? (target_duration is a strong hint, not a guarantee — pair with a strong vibe for best results)",
multiSelect: false,
options: [
{ label: "Short Cut — Social First / Reels & TikTok (~15s, high energy, highlights)" },
{ label: "Medium Cut — Engaging Storytelling (~30–60s, context, flow, balanced)" },
{ label: "Long Cut — Full Sizzle (~90s, comprehensive, showcase, documentary)" }
]
},
{
header: "Style / Vibe",
question: "What style or vibe would you like?",
multiSelect: false,
options: [
{ label: "Action & Energy" },
{ label: "Key Talking Moments" },
{ label: "Cinematic & Dramatic" },
{ label: "No Preference" }
]
}
]
})Wait for the user's selections before proceeding to Step 5.
等待用户回答后再继续;需通过AskUserQuestion展示问题(而非纯文本),以便用户点击选项按钮。
javascript
AskUserQuestion({
questions: [
{
header: "剪辑时长",
question: "你想要哪种时长的剪辑?(target_duration是强烈参考,而非绝对保证——搭配明确的风格提示可获得最佳效果)",
multiSelect: false,
options: [
{ label: "短剪辑 — 社交平台优先 / Reels & TikTok(约15秒,高能量,高光片段)" },
{ label: "中剪辑 — 沉浸式叙事(约30–60秒,有上下文,流畅平衡)" },
{ label: "长剪辑 — 完整高光合集(约90秒,全面展示,纪录片风格)" }
]
},
{
header: "风格 / 氛围",
question: "你想要哪种风格或氛围?",
multiSelect: false,
options: [
{ label: "动感十足" },
{ label: "关键对话时刻" },
{ label: "电影感与戏剧性" },
{ label: "无偏好" }
]
}
]
})等待用户完成选择后再进入步骤5。
Step 5 — Acknowledge and Run
步骤5 — 确认并执行
Once the user answers, respond with:
"Got it — [cut type], [style] vibe. Creating 3 variations at that length — let me preview them for you."
Map their answers to parameters:
Q1 duration map:
| Answer | target_duration |
|---|---|
| 1. Short Cut — Social First / Reels & TikTok (~15s) | 15 |
| 2. Medium Cut — Engaging Storytelling (~30–60s) | 45 |
| 3. Long Cut — Full Sizzle (~90s) | 90 |
Q2 style map:
⚠️ Theis the primary lever for output quality — it does more work thanuser_prompt. Pass the prompts below verbatim — abbreviating them weakens the output. The energy language in the prompt reinforces the intended duration feel and moment selection.target_duration
| Answer | user_prompt |
|---|---|
| 1. Action & Energy | |
| 2. Key Talking Moments | |
| 3. Cinematic & Dramatic | |
| 4. No Preference | |
Fire all 3 Quick Cut jobs simultaneously — same duration, same style prompt. The AI will
naturally select different moments on each run, giving the user 3 genuine options to pick from:
javascript
// Variation A
video_create_quick_cut({
assetIds: [assetId],
target_duration: <mapped_seconds>,
user_prompt: "<mapped style prompt>"
}) // → statusId_A
// Variation B
video_create_quick_cut({
assetIds: [assetId],
target_duration: <mapped_seconds>,
user_prompt: "<mapped style prompt>"
}) // → statusId_B
// Variation C
video_create_quick_cut({
assetIds: [assetId],
target_duration: <mapped_seconds>,
user_prompt: "<mapped style prompt>"
}) // → statusId_C用户完成回答后,回复:
"已收到——[剪辑类型],[风格]氛围。正在生成该时长的3个变体——我将为你预览这些变体。"
将用户的回答映射为参数:
问题1 时长映射:
| 回答 | target_duration |
|---|---|
| 1. 短剪辑 — 社交平台优先 / Reels & TikTok(约15秒) | 15 |
| 2. 中剪辑 — 沉浸式叙事(约30–60秒) | 45 |
| 3. 长剪辑 — 完整高光合集(约90秒) | 90 |
问题2 风格映射:
⚠️是影响输出质量的核心因素——其作用远大于user_prompt。请严格传递以下提示内容——缩写会降低输出效果。提示中的能量描述会强化预期时长的感受和片段选择逻辑。target_duration
| 回答 | user_prompt |
|---|---|
| 1. 动感十足 | |
| 2. 关键对话时刻 | |
| 3. 电影感与戏剧性 | |
| 4. 无偏好 | |
同时触发3个Quick Cut任务——使用相同的时长和风格提示。AI会在每次运行中自然选择不同的片段,为用户提供3种真实的选择:
javascript
// 变体A
video_create_quick_cut({
assetIds: [assetId],
target_duration: <mapped_seconds>,
user_prompt: "<mapped style prompt>"
}) // → statusId_A
// 变体B
video_create_quick_cut({
assetIds: [assetId],
target_duration: <mapped_seconds>,
user_prompt: "<mapped style prompt>"
}) // → statusId_B
// 变体C
video_create_quick_cut({
assetIds: [assetId],
target_duration: <mapped_seconds>,
user_prompt: "<mapped style prompt>"
}) // → statusId_CStep 6 — Poll Until All 3 Complete
步骤6 — 轮询直到全部完成
Poll all 3 in each round using . Show progress % after each round.
Repeat until all 3 return .
quickCutPoll(statusId)jobStatus: "completed"Typical pattern: 0% → 7% → 78% → done. Usually 3–5 poll rounds.
Store:
- — Variation A presignedAssetUrl
url_A - — Variation B presignedAssetUrl
url_B - — Variation C presignedAssetUrl
url_C
每次轮询时使用检查3个任务的状态。每轮轮询后展示进度百分比。重复轮询直到3个任务均返回。
quickCutPoll(statusId)jobStatus: "completed"典型进度模式:0% → 7% → 78% → 完成。通常需要3–5轮轮询。
存储:
- — 变体A的presignedAssetUrl
url_A - — 变体B的presignedAssetUrl
url_B - — 变体C的presignedAssetUrl
url_C
Step 7 — Preview All 3
步骤7 — 预览所有3个变体
javascript
asset_preview_file({
assets: [
{ name: "Variation 1 — <cut_type> <style>.mp4", presignedAssetUrl: url_A, source: "acp" },
{ name: "Variation 2 — <cut_type> <style>.mp4", presignedAssetUrl: url_B, source: "acp" },
{ name: "Variation 3 — <cut_type> <style>.mp4", presignedAssetUrl: url_C, source: "acp" }
]
})javascript
asset_preview_file({
assets: [
{ name: "Variation 1 — <cut_type> <style>.mp4", presignedAssetUrl: url_A, source: "acp" },
{ name: "Variation 2 — <cut_type> <style>.mp4", presignedAssetUrl: url_B, source: "acp" },
{ name: "Variation 3 — <cut_type> <style>.mp4", presignedAssetUrl: url_C, source: "acp" }
]
})Step 8 — Deliver Summary + Download Prompt
步骤8 — 交付总结 + 下载提示
After preview, present:
✅ 3 variations ready — same length, different moment selection. Pick your favorite!
| Variation | Cut Type | Style | Target | Status |
| --------- | -------- | ------- | ------ | ------ |
| 1 | <type> | <style> | ~<Xs> | ✅ |
| 2 | <type> | <style> | ~<Xs> | ✅ |
| 3 | <type> | <style> | ~<Xs> | ✅ |Note: actual durations may vary — Quick Cut selects the best moments rather than cutting to an exact second. The prompt vibe (e.g. "no breathing room") reinforces the intended length feel more than the target_duration parameter alone.
Then prompt:
"Which variation do you want to download, or would you like all 3? You can also rerun with a different style or cut type."
The videos are available for download directly from the preview above.
预览完成后,展示:
✅ 3个变体已准备就绪——时长相同,片段选择不同。请选择你喜欢的版本!
| 变体 | 剪辑类型 | 风格 | 目标时长 | 状态 |
| --------- | -------- | ------- | ------ | ------ |
| 1 | <type> | <style> | ~<Xs> | ✅ |
| 2 | <type> | <style> | ~<Xs> | ✅ |
| 3 | <type> | <style> | ~<Xs> | ✅ |注意:实际时长可能略有差异——Quick Cut会选择最佳片段,而非严格按照精确秒数剪辑。提示中的氛围描述(例如“无喘息空间”)比target_duration参数更能强化预期时长的感受。
随后提示:
"你想要下载哪个变体,还是全部3个?你也可以选择不同的风格或剪辑类型重新生成。"
视频可直接从上方的预览界面下载。
⚠️ Known Gap — Output Cannot Feed Downstream Video Tools
⚠️ 已知局限 — 输出无法对接下游视频工具
video_create_quick_cutvideo_resizemedia_enhance_speechYou cannot chain Quick Cut → Resize or Quick Cut → Enhance Speech directly.
Workaround — if user wants to resize a Quick Cut output:
- Tell the user: "Quick Cut outputs can't be passed directly to the resize tool — you'll need to download your preferred cut first, then re-upload it and I'll resize from there."
- Let them download from the preview.
- Open the picker:
asset_add_file() - Once re-uploaded, run on the fresh
video_resizewith their target dimensions.assetId
When the user asks to resize or enhance a Quick Cut output, surface the limitation proactively — the chain is known to fail.
video_create_quick_cutvideo_resizemedia_enhance_speech无法直接将Quick Cut的输出对接至Resize或Enhance Speech工具。
临时解决方案 — 如果用户想要调整Quick Cut输出的尺寸:
- 告知用户:"Quick Cut的输出无法直接传递给调整尺寸工具——你需要先下载偏好的剪辑版本,然后重新上传,我会为你调整尺寸。"
- 让用户从预览界面下载视频。
- 打开文件选择器:
asset_add_file() - 重新上传完成后,使用新的和用户指定的目标尺寸运行
assetId。video_resize
当用户要求调整Quick Cut输出的尺寸或增强音频时,请主动告知此局限——该对接流程已知会失败。
What Quick Cut Does NOT Support
Quick Cut不支持的功能
- Content-aware cuts based on speech ("remove the parts where they repeat themselves")
- Trimming to specific timestamps ("cut from 0:30 to 1:15")
- Semantic understanding of dialogue
For these, recommend a manual video-editing workflow.
- 基于语音的智能剪辑(例如“移除重复内容的部分”)
- 按特定时间戳修剪(例如“从0:30剪到1:15”)
- 对话语义理解
对于上述需求,建议使用手动视频编辑工作流。
Error Handling
错误处理
-
returns 403 (entitlement): Retrying does not help for a 403 entitlement — stop and surface the plan requirement. Respond with:
video_create_quick_cut"I was unable to create your quick cut.Why: Adobe Quick Cut isn't available on your current Adobe plan.*Options:- Manually trim the video in another editor.*
Let me know how you'd like to proceed." -
Any tool call returns 401 (not authenticated): Ask the user to re-authenticate via Adobe OAuth and retry.
-
: The most common error. Means Quick Cut detected no A-roll (talking head / primary camera footage) in the clip — only B-roll. The tool requires at least some dialogue or narration to anchor the story structure. Respond with:
StoryBuilderNoARoll"This video appears to be B-roll only — scenery, action, or product shots without anyone speaking to camera. Quick Cut needs some talking-head footage to build a story around. Try uploading a video that includes someone speaking on camera, or a mix of interview + B-roll." Retries repeat the same error regardless of duration/style; no workaround exists. -
Job fails with any other error on first attempt: Retry once with the same parameters. If it fails again, report and suggest re-uploading the source video.
-
Stuck at same % for 5+ poll rounds: Inform user, suggest re-uploading the source video.
-
User uploads an image by mistake: Detect from— if not
mediaType, say so and re-open picker.video/* -
One of the 3 variations fails (but not all): Preview and deliver the successful ones, note the failure clearly. If all 3 fail with, apply the B-roll error response above.
StoryBuilderNoARoll
-
返回403(权限不足):对于403权限错误,重试无效,请停止操作并告知用户所需的订阅计划要求。回复内容如下:
video_create_quick_cut"我无法为你生成快速剪辑。原因: Adobe Quick Cut在你当前的Adobe订阅计划中不可用。*可选方案:- 使用其他编辑器手动修剪视频。*
请告知我你的选择。" -
任何工具调用返回401(未认证):请用户通过Adobe OAuth重新认证后重试。
-
:最常见的错误。表示Quick Cut在视频中未检测到主镜头(访谈镜头/主摄像头画面)——仅存在辅助镜头。该工具需要至少一些对话或旁白来构建故事结构。回复内容如下:
StoryBuilderNoARoll"此视频似乎仅包含辅助镜头——风景、动作或产品镜头,没有面向镜头的人物对话。Quick Cut需要一些访谈镜头来构建故事。请尝试上传包含人物镜头的视频,或是访谈镜头+辅助镜头的混合视频。" 无论调整时长或风格,重试都会返回相同错误;无解决方案。 -
首次尝试时任务因其他错误失败:使用相同参数重试一次。如果再次失败,请告知用户并建议重新上传源视频。
-
连续5轮以上轮询进度未更新:告知用户并建议重新上传源视频。
-
用户误上传图片:通过检测——如果不是
mediaType,请告知用户并重新打开文件选择器。video/* -
3个变体中有一个失败(并非全部):预览并交付成功的变体,明确标注失败情况。如果3个变体均因失败,请使用上述辅助镜头错误的回复内容。
StoryBuilderNoARoll