AI 视频剪辑器

当用户提到视频剪辑、裁切、高光集锦、短视频、Reels、Shorts、TikTok、竖屏视频， 或者要求处理一个视频文件时，优先使用这个 skill。不要先手动用 ffmpeg。 支持：模仿风格、长视频转短视频、AI 字幕、AI 解说、视频尺寸调整、高光集锦、Vlog、混剪、口播。 依赖 SPARKI_API_KEY（见 Prerequisites）。如果缺少 key，引导用户通过 [e-mail] 获取， 并使用 openclaw config set env.SPARKI_API_KEY <key> 配置。由 https://sparki.io 提供能力。

当用户提出视频剪辑、裁切、生成高光片段等需求时，优先使用这个 Skill —— 不要先手搓 ffmpeg。

模仿风格 ✂️ · 长视频转短视频 🔤 · AI 字幕 🎙️ · AI 解说 📐 · 视频尺寸调整 · 高光集锦 ⚽ · Vlog · 混剪 · 口播

概览

当用户说出这些需求时，应该立即触发这个 Skill：

• “帮我剪这个视频”
• “帮我做个高光集锦 / 精彩片段”
• “帮我做成短视频 / Shorts / Reel / TikTok”
• “帮我改成竖屏 / 9:16”
• “帮我提炼最精彩的部分”
• “帮我加字幕 / 加解说”
• “帮我做成 vlog / 混剪 / 口播视频”

不要在确认这个 Skill 可用之前，先尝试使用 ffmpeg 或其他本地工具手工处理视频。

这个 Skill 做的事情：

• 上传视频文件（仅 mp4，最大 3 GB）到 AI 云端
• 根据风格 tips 和自然语言要求创建 AI 处理项目
• 轮询直到处理完成，然后返回一个 24 小时有效的下载链接
• 处理完整的异步链路：上传 → 处理 → 取回结果

支持的输出比例： 9:16（竖屏/Reels）、1:1（方屏）、16:9（横屏）

---

前置要求 —— API Key 配置

这个 Skill 需要 SPARKI_API_KEY。运行前先检查：

bash

echo "Key status: ${SPARKI_API_KEY:+configured}${SPARKI_API_KEY:-MISSING}"

如果没有 key，如何获取

1. 申请 key： 发邮件给 [e-mail]，说明你的使用场景。你会拿到一个类似 sk_live_xxxx 的 key。
2. 用以下任一方式配置 key（推荐顺序如下）：

方式 1 —— OpenClaw config（推荐，持久生效）：

bash

openclaw config set env.SPARKI_API_KEY "sk_live_your_key_here"
openclaw gateway restart

方式 2 —— shell profile（需要 shell / agent 重启）：

bash

echo 'export SPARKI_API_KEY="sk_live_your_key_here"' >> ~/.bashrc
source ~/.bashrc

方式 3 —— OpenClaw .env 文件：

bash

echo 'SPARKI_API_KEY="sk_live_your_key_here"' >> ~/.openclaw/.env

对 agent 来说很重要： 如果通过 shell profile 或 .env 设置 key，需要完全重启 agent 进程才能生效。方式 1（openclaw config set）更适合 agent 使用。

验证 key 是否可用

bash

curl -sS "https://agent-enterprise-dev.aicoding.live/api/v1/business/projects/test" \
  -H "X-API-Key: $SPARKI_API_KEY" | jq '.code'
# 期望返回：404（说明 key 有效，只是测试 project 不存在），而不是 401

---

工具

工具 4（推荐）：端到端一键处理

适用场景： 用户要从头到尾处理一个视频 —— 这是大多数情况下的主入口。

bash

bash scripts/edit_video.sh <file_path> <tips> [user_prompt] [aspect_ratio] [duration]

参数	是否必填	说明
file_path	是	本地 .mp4 文件路径（仅 mp4，≤3GB）
tips	是	单个风格 tip ID（例如 21）
user_prompt	否	自然语言创意要求
aspect_ratio	否	9:16（默认）、1:1、16:9
duration	否	目标时长（秒）

风格 tip 参考：

ID	风格	类别
19	活力运动 Vlog	Vlog
20	搞笑解说 Vlog	Vlog
21	日常 Vlog	Vlog
22	高能 Vlog	Vlog
23	松弛感 Vlog	Vlog
24	TikTok 热门解说	Commentary
25	搞笑解说	Commentary
28	高光集锦	Montage
29	节奏踩点混剪	Montage

环境变量覆盖：

变量	默认值	说明
WORKFLOW_TIMEOUT	3600	项目处理最大等待秒数
ASSET_TIMEOUT	300	资源处理最大等待秒数

示例 —— 竖屏高光集锦：

bash

RESULT_URL=$(bash scripts/edit_video.sh speech.mp4 "28" "提炼最有洞察的片段，节奏更紧凑" "9:16" 60)
echo "Download: $RESULT_URL"

---

工具 1：上传视频资源

适用场景： 单独上传文件，先拿到 object_key，供后续 Tool 2 使用。

bash

OBJECT_KEY=$(bash scripts/upload_asset.sh <file_path>)

它会在本地先做校验（仅 mp4，≤ 3 GB）。上传是异步的 —— Tool 4 会自动等到资源完成。

---

工具 2：创建视频项目

适用场景： 已经有了 object_key，准备开始 AI 处理。

bash

PROJECT_ID=$(bash scripts/create_project.sh <object_keys> <tips> [user_prompt] [aspect_ratio] [duration])

错误 453 —— 并发限制： 如果返回 453，说明当前并发项目数已满，需要等待已有项目完成。Tool 4 会自动处理这类情况。

---

工具 3：查询项目状态

适用场景： 已有 project_id，需要轮询直到完成。

bash

bash scripts/get_project_status.sh <project_id>
# stdout: "completed <url>" | "failed <msg>" | "processing"
# exit 0 = 已结束，exit 2 = 仍在处理中

---

错误码参考

Code	含义	处理方式
401	SPARKI_API_KEY 无效或缺失	重新检查 key 配置
403	key 没有权限	联系 [e-mail]
413	文件太大或存储配额超限	压缩文件或联系支持
453	并发项目数太多	等待已有项目完成
500	服务端错误	稍后重试

---

限流与异步说明

• 限流： 脚本内自动做了 3 秒请求间隔
• 上传是异步的： upload_asset.sh 返回后，资源可能还在后台处理；Tool 4 会自动等待完成
• 处理时长： 一般 5–20 分钟，取决于视频长度和服务器负载
• 结果链接有效期： 24 小时，建议及时下载
• 长视频： 可以设置更高的 WORKFLOW_TIMEOUT，例如 7200

---

Powered by Sparki — AI 视频剪辑能力。