MuleRun通过五步实现背景音智能匹配：一、配置API连接参数；二、构建推荐请求负载；三、映射API响应字段到音轨属性；四、设置失败回退机制；五、触发实时匹配并验证输出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
mulerun是一款支持背景音智能匹配的音频处理工具，当需要为视频或内容自动匹配适配的音乐时，可通过调用外部音乐推荐api实现动态选曲。以下是调用音乐推荐api并完成背景音智能匹配的具体操作步骤：一、配置API连接参数
在MuleRun中启用外部API调用前，需预先设置目标音乐推荐服务的访问凭证与端点地址，确保请求可被正确路由和认证。
1、打开MuleRun主界面，点击右上角“设置”图标，进入“网络与API”选项卡。
2、在“推荐服务API”区域，输入目标API的Base URL，例如https://api.musicmatch.com/v1/recommend。
3、在“认证方式”下拉菜单中选择Bearer Token，并粘贴已获取的API密钥至对应输入框。
4、勾选“启用自动鉴权头注入”，使每次请求自动携带Authorization: Bearer {token}头。
二、构建推荐请求负载
MuleRun通过结构化JSON Payload向音乐推荐API传递上下文信息，如视频时长、情绪标签、节奏范围等，以提升匹配精度。
1、在项目编辑页点击“音频匹配”模块，展开“高级推荐设置”面板。
2、点击“自定义请求体”开关，切换为手动模式。
3、在文本框中填入标准JSON格式请求体，例如：{"duration_sec":120,"mood":["calm","inspiring"],"bpm_range":[80,110]}。
4、确认字段名与目标API文档要求完全一致，避免因键名大小写或嵌套层级错误导致400响应。
三、映射API响应字段到音轨属性
音乐推荐API返回的JSON响应通常包含多个候选曲目，需将其中的关键字段（如曲目ID、URL、版权状态）映射至MuleRun内部音轨元数据结构，供后续播放与导出使用。
1、在“响应解析”区域点击“添加映射规则”按钮。
2、在“源路径”栏输入JSONPath表达式，例如$.tracks[0].id，用于提取首条推荐曲目的唯一标识。
3、在“目标字段”下拉菜单中选择“音轨ID”，完成绑定。
4、重复上述操作，分别映射$.tracks[0].preview_url至“试听链接”，$.tracks[0].license_status至“授权状态”。
四、设置失败回退机制
当API调用超时、返回空结果或HTTP非2xx状态码时，MuleRun需启用预设回退策略，避免流程中断，保障背景音匹配持续可用。
1、在“错误处理”面板中启用“启用回退音轨库”开关。
2、点击“选择本地音轨集”，从已导入的本地文件夹中指定一个含至少5首BGM的目录作为备用池。
3、在“触发条件”中勾选HTTP状态码 ≥ 400 或 响应体为空。
4、设置“最大重试次数”为2次，间隔延迟为800毫秒。
五、触发实时匹配并验证输出
完成全部配置后，MuleRun将在用户执行“生成背景音”指令时，同步发起API请求、解析响应、加载音轨并进行时长对齐处理，最终输出匹配结果。
1、在时间轴上选中待配乐的视频片段，右键选择“智能匹配背景音乐”。
2、观察底部状态栏，确认显示“正在请求音乐推荐…” → “解析成功” → “音轨加载完成”三阶段提示。
3、播放预览轨道，检查起始静音段是否已根据视频画面节奏自动裁剪，且结尾淡出时长是否为1.2秒。
4、点击“导出音轨”按钮，在弹出窗口中确认输出格式为MP3，采样率锁定为44.1kHz，位深度为16bit。
