用途:为已有视频添加音频轨道,覆盖两类场景并可串联:添加背景音乐(BGM)与添加旁白配音。添加 BGM 时工具内部根据 prompt 描述检索素材库匹配音乐,或通过 audio_url 指定自定义音频;video_volume 默认 1,即不压低原声。添加旁白时根据 prompt 中的音色描述检索音色素材,video_volume 默认 0,即压低原声以突出旁白。需要同时加 BGM 和旁白时,串联执行 video_bgm_add → video_narration_add。该技能不处理视频拼接、拼接与配乐一体化、纯音乐或歌曲生成,以及视频内容与画面编辑。
依赖与凭证:需要 meitu-cli 版本不低于 2.0.6;CONFIG AKSK 通过 meitu tools update 配置,EXEC AKSK 用于执行命令;需设置环境变量 MEITU_OPENAPI_TOOL_TASK_MODE=command。工作流程分为 Preflight、Execute、Deliver 三步:先用 meitu --version 检查安装、用 meitu auth verify --json 验证凭证并解析输出目录;再根据用户原话路由到对应 API;最后输出命名格式为 {YYYY-MM-DD}_{descriptive-name}_audio-add.mp4 的 MP4 文件,项目模式存至 ./output/,一次性模式存至 $VISUAL/output/video-audio-add/。
主要参数:video_list(视频地址列表,必填)与 prompt(BGM 为音乐风格偏好,旁白为旁白文案加音色,必填);video_bgm_add 额外支持 audio_url(存在时跳过内部素材检索)、music_volume(0–1,默认 1)、video_volume(0–1,默认 1);video_narration_add 额外支持 video_volume(0–1,默认 0)。bgm_material_id 与 voice_material_id 不作为外部入参,由工具内部根据 prompt 自动检索,无匹配时使用默认素材或音色。
调用示例:BGM 场景使用 meitu video-audio-add --video_list {urls} --prompt "{风格}" [--audio_url {url}] --json --download-dir {output_dir} --skill_name skill_video-audio-add;旁白场景使用相同命令并将 prompt 替换为旁白文案加音色。
限制与错误处理:video_list 缺失时提示提供视频链接且不调用;列表中任一视频不可访问直接返回错误不重试;旁白场景缺少 prompt 时提示提供配音文案;BGM 场景 audio_url 不可访问则回退内部检索默认音乐;内部检索无匹配使用默认素材或音色继续;串联第一步失败则停止串联;API 调用失败重试一次,仍失败返回错误;内容合规拦截直接返回提示,不重试。视频拼接、歌曲生成与视频画面编辑等功能暂未提供。