qinghu-video-audio-extract

# AI视频音频提取 | 提取背景音乐 | 人声提取 | 视频转音频 | 青虎AI 本地 ffmpeg 完成音频提取；素材只有平台分享链接时先用 `qhkit video-inspire` 解析出视频直链再提取。 ## 何时触发 - 「把这条视频的音频/BGM 提出来」 - 「视频转 MP3」「拿这条口播的音轨」 ## 使用配方 **环境**：需要 ffmpeg。缺失时安装：Linux `apt-get install -y ffmpeg`（或对应包管理器）；macOS `brew install ffmpeg`；Windows `winget install ffmpeg`。 ```bash # 本地文件 / 视频直链 → MP3（-vn 去视频流） ffmpeg -i "输入视频.mp4" -vn -acodec libmp3lame -q:a 2 输出音频.mp3 # 要无损：-acodec pcm_s16le 输出 .wav ffmpeg -i "输入视频.mp4" -vn -acodec pcm_s16le 输出音频.wav ``` 只有抖音等平台**分享链接**（不是直链）时，先用 qhkit 解析。缺 qhkit（npm 包 `@iqinghu/qhkit`，需 Node ≥ 18）就地安装：`npm i -g @iqinghu/qhkit`（官方源慢或超时时加 `--registry=https://registry.npmmirror.com`）；无密钥（命令返回 `stage:"config"`）时执行 `qhkit config set --token <密钥> --env prod`（让用户在 https://www.iqinghu.com/workbench/login?type=1&urlCode=1788417527636 注册/登录后，到工作台 APIKeys 页 https://www.iqinghu.com/workbench/dashboard/api-keys 创建密钥发给你）： ```bash qhkit video-inspire generate '{"resourceUrl":"https://v.douyin.com/xxxx/"}' qhkit video-inspire status '{"inspireTaskId":276}' # 返回里的 playVideo 就是直链 ffmpeg -i "<playVideo 直链>" -vn -acodec libmp3lame -q:a 2 音频.mp3 ``` - 交付：给出本地文件路径；当前环境支持文件外发时按渠道约定发送音频文件。 - 顺带产出的 `videoScript`（脚本）如果对用户有用可以一并交付。 ## 能力边界 - 人声/伴奏分离（消音留 BGM）超出本技能范围，如实告知用户需要专业工具。 - 青虎AI 工作台「爆款视频复刻」页也有「链接解析音频/本地视频提取音频」入口，用户偏好网页操作时可引导到 https://www.iqinghu.com。 - 提取的音乐用于商用时提醒 BGM 版权风险。