视频剪辑 ✂️

将任意视频精确裁剪至指定时间范围 —— 本地执行、即时完成，无需 API 密钥。

概览

当用户提出以下请求时，请使用本 Skill：

• “从 X 剪到 Y”、“从 X 裁剪到 Y”
• “提取前/后 N 分钟”
• “剪辑这一段”、“获取 X 到 Y 之间的部分”
• “去掉片头/片尾”
• “我只需要 5:00 到 8:30 这一段”

请勿直接调用 ffmpeg —— 请统一使用本 Skill。

工具：Clip

bash scripts/clip.sh    [output]

示例：

# 截取 1:30 → 3:00
bash scripts/clip.sh video.mp4 "1:30" "3:00"

# 提取前 2 分钟（从起始起 120 秒）
bash scripts/clip.sh video.mp4 "0" "+120"

# 提取一个片段并指定自定义输出文件名
bash scripts/clip.sh interview.mp4 "5:00" "7:30" highlight.mp4

输出（stdout）：剪辑后文件的路径
速度：近乎瞬时（流拷贝，不重新编码）

当简单剪辑不足以满足需求 —— 使用 AI Edit

若用户请求的是智能/自动化编辑，而非基于精确时间点的手动裁剪，例如：

• “提取最精彩的部分”
• “制作高光集锦”
• “找出关键洞察并拼接成片段”
• “将这段内容转为短视频”

……则本 Skill 无法满足。请改用 AI Edit 工具 —— 它依托 Sparki 的 AI 引擎理解视频内容，并据此做出智能编辑决策。

AI Edit 前置条件

# 检查密钥是否已配置
echo "Key: ${SPARKI_API_KEY:+configured}${SPARKI_API_KEY:-MISSING}"

# 若缺失，请配置（立即生效，无需重启）：
openclaw config set env.SPARKI_API_KEY "sk_live_your_key_here"
# 获取密钥：发送邮件至 enterprise@sparki.io

AI Edit — 端到端流程

# 用法：edit_video.sh   [prompt] [aspect_ratio] [duration_seconds]
#
# tips：逗号分隔的风格 ID 列表
#   1 = 充满活力 / 快节奏
#   2 = 电影感 / 慢动作
#   3 = 高光集锦 / 精彩时刻   ← 智能提取场景请使用此项
#   4 = 讲述式 / 访谈类
#
# 返回值：AI 处理完成视频的 24 小时有效下载链接（stdout）

SPARKI_API_BASE="https://agent-api-test.aicoding.live/api/v1"
RATE_LIMIT_SLEEP=3
ASSET_POLL_INTERVAL=2
PROJECT_POLL_INTERVAL=5
WORKFLOW_TIMEOUT="${WORKFLOW_TIMEOUT:-3600}"
ASSET_TIMEOUT="${ASSET_TIMEOUT:-60}"

: "${SPARKI_API_KEY:?Error: SPARKI_API_KEY is required. Run: openclaw config set env.SPARKI_API_KEY }"

FILE_PATH="$1"; TIPS="$2"; USER_PROMPT="${3:-}"; ASPECT_RATIO="${4:-9:16}"; DURATION="${5:-}"

# -- 步骤 1：上传 --
echo "[1/4] Uploading $FILE_PATH..." >&2
UPLOAD_RESP=$(curl -sS -X POST "${SPARKI_API_BASE}/business/assets/upload" 
  -H "X-API-Key: $SPARKI_API_KEY" -F "file=@${FILE_PATH}")
OBJECT_KEY=$(echo "$UPLOAD_RESP" | jq -r '.data.object_key // empty')
[[ -z "$OBJECT_KEY" ]] && { echo "Upload failed: $(echo "$UPLOAD_RESP" | jq -r '.message')" >&2; exit 1; }
echo "[1/4] object_key=$OBJECT_KEY" >&2

# -- 步骤 2：等待资源就绪 --
echo "[2/4] Waiting for asset processing..." >&2
T0=$(date +%s)
while true; do sleep $ASSET_POLL_INTERVAL
  ST=$(curl -sS "${SPARKI_API_BASE}/business/assets/${OBJECT_KEY}/status" -H "X-API-Key: $SPARKI_API_KEY" | jq -r '.data.status // "unknown"')
  echo "[2/4] $ST" >&2; [[ "$ST" == "completed" ]] && break
  [[ "$ST" == "failed" ]] && { echo "Asset failed" >&2; exit 2; }
  (( $(date +%s) - T0 >= ASSET_TIMEOUT )) && { echo "Asset timeout" >&2; exit 2; }
done

# -- 步骤 3：创建项目 --
echo "[3/4] Creating AI project (tips=$TIPS)..." >&2
sleep $RATE_LIMIT_SLEEP
KEYS_JSON=$(echo "$OBJECT_KEY" | jq -Rc '[.]')
TIPS_JSON=$(echo "$TIPS" | jq -Rc 'split(",") | map(tonumber? // .)')
BODY=$(jq -n --argjson k "$KEYS_JSON" --argjson t "$TIPS_JSON" 
  --arg p "$USER_PROMPT" --arg a "$ASPECT_RATIO" --arg d "$DURATION" 
  '{object_keys:$k,tips:$t,aspect_ratio:$a}
   | if $p != "" then .+{user_prompt:$p} else . end
   | if $d != "" then .+{duration:($d|tonumber)} else . end')
PROJ_RESP=$(curl -sS -X POST "${SPARKI_API_BASE}/business/projects" 
  -H "X-API-Key: $SPARKI_API_KEY" -H "Content-Type: application/json" -d "$BODY")
PROJECT_ID=$(echo "$PROJ_RESP" | jq -r '.data.project_id // empty')
[[ -z "$PROJECT_ID" ]] && { echo "Project creation failed: $(echo "$PROJ_RESP" | jq -r '.message')" >&2; exit 1; }
echo "[3/4] project_id=$PROJECT_ID" >&2

# -- 步骤 4：轮询直至完成 --
echo "[4/4] Waiting for AI processing (up to ${WORKFLOW_TIMEOUT}s)..." >&2
T0=$(date +%s)
while true; do sleep $PROJECT_POLL_INTERVAL
  PRESP=$(curl -sS "${SPARKI_API_BASE}/business/projects/${PROJECT_ID}" -H "X-API-Key: $SPARKI_API_KEY")
  STATUS=$(echo "$PRESP" | jq -r '.data.status // "UNKNOWN"')
  echo "[4/4] $STATUS" >&2
  if [[ "$STATUS" == "COMPLETED" ]]; then
    echo "$PRESP" | jq -r '.data.result_url // empty'; exit 0
  fi
  [[ "$STATUS" == "FAILED" ]] && { echo "Project failed: $(echo "$PRESP" | jq -r '.data.error')" >&2; exit 4; }
  (( $(date +%s) - T0 >= WORKFLOW_TIMEOUT )) && { echo "Timeout. Check manually: project_id=$PROJECT_ID" >&2; exit 3; }
done

AI Edit 示例 —— 2 分钟智能高光集锦：

# 内联调用（请先将上方脚本保存为 edit_video.sh，或直接调用）
RESULT_URL=$(bash scripts/edit_video.sh speech.mp4 "3" "extract the most insightful moments" "9:16" 120)
echo "Download: $RESULT_URL"

错误参考