说明：宿主若在环境中注入 ARKSKILLAPIBASE / ARKSKILLAPIKEY（例如供其他 Skill 走 SkillHub 网关），与本 Skill 的 AMKAPIKEY、ARKAPIKEY（视频理解）相互独立，请勿混淆。

⚠️ 严格执行：必须先完成 环境检查；环境缺失须提示用户，不可跳过。

为 byted-mediakit-tools 所在目录。
当前方法返回的 链接仅供下载，不支持播放能力
禁止修改任何返回数据信息，如 playurl 、requestid 、task_id 等
用户明确声明需要重新执行时：除 understandvideocontent 外的方法需 生成新的 clienttoken（不要复用上一次的 clienttoken），避免命中上次的幂等结果

火山引擎 AI MediaKit 音视频处理工具集

概览

本工具集基于火山引擎 AI MediaKit 提供一站式音视频处理能力，包括：

• - 🎬 视频理解：AI 分析视频内容，生成自然语言描述
• ✂️ 音视频剪辑：精确裁剪音视频时长
• 🔗 音视频拼接：拼接多个片段，支持转场效果
• 🎵 音频提取：从视频中提取音频轨道
• 🖼️ 画质增强：提升视频画质、分辨率、帧率
• 🎬 文生视频：图片生成视频，支持动画效果
• 🎧 音视频合成：合成新的音轨与视频

---

获取密钥

在开始使用前，请先获取必要的 API 密钥：

• - AI MediaKit 控制台：https://console.volcengine.com/imp/ai-mediakit/
• 方舟模型与密钥：https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seed-1-8

---

快速开始

1. 环境配置

在 /.env 中配置环境变量（首次使用会自动创建模板）：

bash

AMK API Key (必填) - https://console.volcengine.com/imp/ai-mediakit/

AMKAPIKEY=youramkapikeyhere

AMK 环境取值 prod 或 boe

AMK_ENV=prod

是否启用 client_token 自动注入（用于幂等）

AMKENABLECLIENT_TOKEN=false

方舟 密钥（可选，仅使用视频理解功能时必须配置）

ARKAPIKEY=yourarkapikeyhere

方舟 模型ID（可选，仅使用视频理解功能时必须配置）

ARKMODELID=doubao-seed-1-8

2. 依赖安装

bash
cd /scripts
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -U pip
python -m pip install -r requirements.txt

---

核心功能

同步能力（立即返回结果）

能力	说明
understandvideocontent	视频内容理解，使用 AI 分析视频并生成自然语言描述

异步能力（默认自动等待结果）

能力	说明
trimmediaduration	裁剪音视频时长，精确到毫秒
concatmediasegments

拼接多个音视频片段，支持转场效果 | | extract_audio | 从视频中提取音频轨道，支持 mp3/m4a 格式 | | enhance_video | 视频画质增强，支持超分、插帧等 | | imagetovideo | 图片生成视频，支持动画和转场 | | muxaudiovideo | 音视频合成，支持时长对齐 |

辅助能力

能力	说明
query_task	查询异步任务执行状态和结果

---

使用示例

视频理解

bash
./byted-mediakit-tools.sh understandvideocontent \
--video_url https://example.com/video.mp4 \
--prompt 总结视频内容 \
--fps 1

视频裁剪

bash

裁剪前 10 秒

./byted-mediakit-tools.sh trimmediaduration \
--type video \
--source https://example.com/video.mp4 \
--start_time 0 \
--end_time 10

音视频拼接

bash
./byted-mediakit-tools.sh concatmediasegments \
--type video \
--sources https://example.com/1.mp4 https://example.com/2.mp4

音频提取

bash
./byted-mediakit-tools.sh extract_audio \
--video_url https://example.com/video.mp4 \
--format mp3

画质增强

bash
./byted-mediakit-tools.sh enhance_video \
--video_url https://example.com/video.mp4 \
--tool_version professional \
--resolution 1080p

图片生成视频

bash
./byted-mediakit-tools.sh imagetovideo \
--images imageurl=https://example.com/1.jpg,duration=3,animationtype=zoom_in \
imageurl=https://example.com/2.jpg,duration=3,animationtype=pan_left

音视频合成

bash
./byted-mediakit-tools.sh muxaudiovideo \
--video_url https://example.com/video.mp4 \
--audio_url https://example.com/audio.mp3 \
--isaudioreserve false

异步任务（不等待结果）

bash

使用 --no-wait 立即返回 task_id

./byted-mediakit-tools.sh --no-wait trimmediaduration \
--type video \
--source https://example.com/video.mp4 \
--start_time 0 \
--end_time 10

查询任务结果

./byted-mediakit-tools.sh querytask --taskid amk-xxx-xxx

---

响应格式

同步响应（视频理解）

json
{
status: success,
result: {
choices: [
{
role: assistant,
content: 视频内容分析结果...
}
]
}
}

异步响应（默认自动等待）

json
{
task_id: amk-tool-extract-audio-xxxxxxxxxxxxxx,
duration: 82.454056,
playurl: https://example.vod.cn-north-1.volcvideo.com/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.mp3?preview=1&authkey=*,
request_id: 20260401xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx,
status: completed,
task_type: extract-audio
}

异步响应（--no-wait）

json
{
status: pending,
task_id: amk-xxx-xxx,
message: 任务已提交，已跳过等待，可调用 querytask 接口传入 taskid 查询结果,
queryexample: ./byted-mediakit-tools.sh querytask --task_id amk-xxx-xxx
}

错误响应

json
{
status: failed/canceled/timeout,
task_id: amk-xxx-xxx,
message: 错误详情
}

---

详细文档

各功能的详细参数说明请参考 reference/ 目录下的对应文档：

能力	文档链接
understandvideocontent	reference/understandvideocontent.md
querytask

reference/query_task.md |
| concatmediasegments | reference/concatmedia_segments.md |
| enhancevideo | reference/enhancevideo.md |
| extractaudio | reference/extractaudio.md |
| imagetovideo | reference/imageto_video.md |
| muxaudiovideo | reference/muxaudio_video.md