跳转到主要内容
Youka 提供了一个 MCP 服务器。MCP(Model Context Protocol,模型上下文协议)是 AI 助手连接外部工具的标准方式。连接后,你可以让助手执行诸如“为 ~/Music/song.mp3 制作一个卡拉 OK 视频”之类的请求,它会在你的 Youka 账号中创建项目,等待处理完成,并给你编辑器链接或下载链接。 该服务器适用于任何支持带自定义请求头的远程(Streamable HTTP)服务器的 MCP 客户端,例如 Claude Code、Cursor 和 Codex。
面向 ChatGPT 和 Claude 的官方 Youka 应用即将推出。在此之前,请使用本页中的客户端并配合 Youka API key。

你需要什么

服务器信息:
你的 API key 可对你的 Youka 账号及其 credits 进行完全访问。不要把它放进共享文件和代码仓库中。如果 key 泄露,请在账号页面删除它并创建新的 key。

连接你的助手

在终端中运行以下命令,将 YOUR_API_KEY 替换为你的 key:
检查是否连接成功:
你应该会看到 youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected。默认情况下,服务器只会为当前文件夹添加。添加 --scope user 可在每个文件夹中使用 Youka。

试试它

用自然语言向助手提问。例如:
一个典型的卡拉 OK 请求大致流程如下:
1

上传

助手向 Youka 获取上传链接并上传你的文件。上传是免费的。
2

检查费用

它会检查该项目会消耗多少 credits,并与你的余额进行对比。
3

创建项目

Youka 会移除人声并同步歌词。这需要几分钟。助手会持续检查状态,直到项目就绪。
4

编辑或导出

你会得到一个链接,用于在 Youka 编辑器中打开项目。如果你请求视频文件,助手会将其导出并提供下载链接。
创建项目本身不会自动渲染视频。你可以自行决定何时导出,因此你可以先修正歌词或样式,无论是在聊天中还是在 Youka editor 中。

助手可以做什么

Credits 与安全

  • 与网页版相同的 credits。 创建项目、再次同步歌词、以及导出,其费用与在 online.youka.io 上相同。
  • 先检查费用。 如果你的 credits 不足,Youka 会拒绝请求并说明原因,不会扣费。
  • 不会重复扣费。 如果助手在超时后重试请求,Youka 会识别这是重试,并返回原始结果,而不是再次扣费。
  • Credits 在 Youka 内购买。 助手无法购买 credits。要增加 credits,请参见 Buy more credits。
  • 付费工具仅在你要求时运行。 只有当你提出要求时,助手才会创建项目、同步歌词或导出。

故障排查

API key 缺失或无效。请检查请求头是否严格为 Authorization: Bearer yk_...,确保 Bearer 后有一个空格,并且 key 内部没有多余空格或引号。如果你在账号页面删除了该 key,请创建一个新的并更新你的客户端。对于通过 YOUKA_API_KEY 读取 key 的 Codex 和 Cursor 配置,请确保该变量已在应用启动时所使用的环境中设置。
让助手告诉你余额,或在 online.youka.io 查看。然后 buy more credits 并再次发起请求。
让助手展示该项目,其中包含错误信息。请确保文件是受支持的音频或视频格式,并且未超过账号所显示的上传限制。
将正确歌词告诉助手并让它重新同步,或打开编辑器链接并自行 edit the lyrics。然后再导出一次。

相关文档