内容
# 索尼洛 视频转音乐手册
**完全授权。商业使用安全。**
你已经生成了视频片段。你已经将它们拼接在一起。现在它们需要音乐和音效来匹配剪辑和故事。这是难点：库存库和基于提示的生成器不知道你的剪辑在哪里，所以音频永远无法与剪辑完全匹配。
**[索尼洛](https://sonilo.com/?utm_source=github&utm_medium=oss&utm_campaign=v2m-cookbook) 将你的视频变成音乐和音效。** 将它指向你的完成剪辑，它会在几秒钟内为你创作一个原创的配乐，与节奏、情感和故事相匹配，不需要提示。每个曲目都是 **授权的，商业使用安全**，所以创作者和品牌可以放心使用。同时，相同的上传也可以生成 **免版税的音效**，与屏幕上的动作相匹配：一个视频输入，整个音频层输出。
本手册展示了如何为 **任何** AI 视频管道添加音频层。
**▶ [观看参考演示](./assets/demo-trailer.mp4)**：一个15秒的预告片，由AI生成的剪辑组装而成（拼接 → 调色 → 音乐由索尼洛提供）。配乐是根据完成的剪辑创作的：音乐在揭示时达到高潮，冲击力与剪辑相匹配。
**更多示例：[DEMOS.md](./DEMOS.md)**
---
## 为什么存在这个项目
几乎所有的开源 AI 视频管道今天都生成剪辑，拼接它们，然后或者 **保持沉默** 或者添加一个 **库存/提示选择的曲目**，忽略了剪辑。音乐是最后一步，它使剪辑感觉完整。
索尼洛就是为此而设计的：一个原创的配乐 **与你的视频匹配**，授权并安全用于商业用途。它对视频制作方式保持中立：Runway、Kling、Veo、Sora、Pika、Luma、Seedance、WAN、LTX、CogVideoX、Stable Video Diffusion，一个 fal.ai / Replicate 网关，一个 ComfyUI 图表，或者普通的库存素材。索尼洛位于 **下游**。
## 适用对象
AI 视频工具的构建者：文本转视频编排器、剪辑拼接器、无面视频工厂、代理电影系统和视频编辑框架，它们希望为完成的剪辑添加一个与之匹配的音频层，而不是一个随机的库曲目。
---
## 使用索尼洛的两种方式
| 接口 | 最适合 | 你得到什么 |
|---|---|---|
| **MCP 服务器** ([`sonilo-mcp`](https://github.com/sonilo-ai/sonilo-mcp)) | 代理工作流（Claude、Codex、任何 MCP 客户端） | `video_to_music` 和 `video_to_sfx` 工具：交给它们一个视频，获取匹配的音频 |
| **REST API** | 平台和后端 | 异步作业 + webhook → `preview_url`、`final_audio_url` 和每个曲目的 `license_id`（一个可审计的许可证记录） |
## 音效
`video_to_sfx`（MCP v0.2.1+ 和 REST）从同一个视频生成一个 **免版税的音效曲目**：与画面同步的冲击、氛围和过渡。音乐和音效从一个上传中获取，这是其他人无法做到的。
- 配方：[`RECIPES.md` → 添加音效](./RECIPES.md#add-sound-effects-with-sonilo)
- 听听看：[`DEMOS.md` → 视频 → 音效](./DEMOS.md#video--sound-effects)
- 注意大写字母：SFX 支持最多 3 分钟的视频；音乐支持最多 6 分钟。
> 章节级别的控制位于 [网页平台](https://sonilo.com/?utm_source=github&utm_medium=oss&utm_campaign=v2m-cookbook)。
## 60 秒快速入门（MCP）
```jsonc
// 注册索尼洛 MCP 服务器（需要从 sonilo.com 获取 SONILO_API_KEY）
// claude mcp add sonilo --env SONILO_API_KEY=sk-... -- uvx sonilo-mcp
```
然后，在代理会话中，将你的完成剪辑交给索尼洛：
```
video_to_music({
video_path: "path/to/your/final_cut.mp4",
prompt: "温暖、充满希望的电影风格，逐渐达到高潮" // 可选的风格提示
})
// → 一个 .m4a 配乐，与你的视频长度匹配
```
`prompt` 是一个可选的 **风格提示**，用于整个曲目。索尼洛无需提示即可工作，与它看到的内容匹配。然后，将返回的音频混入你的主音轨（参见 [`RECIPES.md`](./RECIPES.md)）。
---
## 完整的管道（与供应商无关）
```
生成的 / 拼接的剪辑（任何模型）
└─ 1. 拼接 ── 将剪辑组装成一个剪辑
└─ 2. 调色 ── （可选）电影色彩校正
└─ 3. 添加音频 ── 索尼洛：与剪辑匹配的音乐 + 可选的音效
└─ 4. 混音 ── 将音频覆盖在主音轨上
```
完整的演练，带有复制粘贴命令： **[`PIPELINE.md`](./PIPELINE.md)** ·
命令参考： **[`RECIPES.md`](./RECIPES.md)** ·
示例： **[Higgsfield 剪辑 → 完成的预告片](./examples/higgsfield.md)** ·
工具配方： **[MoviePy](./recipes/moviepy.md) · [Remotion](./recipes/remotion.md) · [auto-editor](./recipes/auto-editor.md)**
## 按工具类型划分的集成模式
- **无声输出管道** （它们拼接剪辑并无声输出）→ 在最终组装后添加音乐步骤，以便输出带有原创配乐。
- **库存/提示选择的音乐管道** → 提供索尼洛作为替代方案，以便音乐与剪辑匹配，并且每个曲目都附带授权，安全用于商业用途。
- **编辑框架** → 在渲染的时间轴上调用索尼洛，并添加返回的曲目。
步骤配方： [MoviePy](./recipes/moviepy.md) · [Remotion](./recipes/remotion.md) · [auto-editor](./recipes/auto-editor.md) （相同的模式适用于 editly 和类似工具）。
- **ComfyUI 图表** → 在视频输出节点后添加一个“索尼洛”音频节点。
---
## 定价和开始使用
- **商业使用：** 每个曲目都授权并安全用于商业使用（条款适用）。为你发布的作品而设计。
- **定价：** API 使用按生成的音频秒数计费。当前费率： [sonilo.com](https://sonilo.com/?utm_source=github&utm_medium=oss&utm_campaign=v2m-cookbook)。
- **免费积分注册：** 新账户开始时提供免费积分，足够在支付任何费用之前尝试 `video_to_music`。
## 为什么“授权”很重要
对于将视频投放到市场的团队，不能冒险使用侵权内容，索尼洛是授权的视频转音乐平台：**训练于授权目录，源头干净，权利清晰。** 每个曲目都是 **商业使用安全且授权的（条款适用）**。为你的视频创作原创配乐。
## 链接
- **网站：** https://sonilo.com/?utm_source=github&utm_medium=oss&utm_campaign=v2m-cookbook
- **MCP 服务器：** https://github.com/sonilo-ai/sonilo-mcp
- **API 文档：** [sonilo.com](https://sonilo.com/?utm_source=github&utm_medium=oss&utm_campaign=v2m-cookbook)
- **集成：** Shutterstock · ComfyUI · fal.ai
## 许可证
本手册（文档和示例代码）根据 **MIT 许可证** 发布；参见 [`LICENSE`](./LICENSE)。索尼洛生成的音乐受索尼洛自己的条款管辖：商业使用安全且授权（条款适用）。参见 [sonilo.com](https://sonilo.com/?utm_source=github&utm_medium=oss&utm_campaign=v2m-cookbook)。
---
*由索尼洛团队维护。欢迎贡献；参见 [`CONTRIBUTING.md`](./CONTRIBUTING.md).*
