面向 ChatGPT 和 Claude 的官方 Youka 应用即将推出。在此之前,请使用本页中的客户端并配合 Youka API key。
你需要什么
- 一个有余额(credits)的 Youka 账号。MCP 服务器与网页版使用相同的 credits。参见 Understanding credits。
- 一个 Youka API key。在 online.youka.io/account 的 API keys 下创建。参见 Authentication。
连接你的助手
- Claude Code
- Cursor
- Codex
- Other clients
在终端中运行以下命令,将 检查是否连接成功:你应该会看到
YOUR_API_KEY 替换为你的 key:youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected。默认情况下,服务器只会为当前文件夹添加。添加 --scope user 可在每个文件夹中使用 Youka。试试它
用自然语言向助手提问。例如:1
上传
助手向 Youka 获取上传链接并上传你的文件。上传是免费的。
2
检查费用
它会检查该项目会消耗多少 credits,并与你的余额进行对比。
3
创建项目
Youka 会移除人声并同步歌词。这需要几分钟。助手会持续检查状态,直到项目就绪。
4
编辑或导出
你会得到一个链接,用于在 Youka 编辑器中打开项目。如果你请求视频文件,助手会将其导出并提供下载链接。
助手可以做什么
Credits 与安全
- 与网页版相同的 credits。 创建项目、再次同步歌词、以及导出,其费用与在 online.youka.io 上相同。
- 先检查费用。 如果你的 credits 不足,Youka 会拒绝请求并说明原因,不会扣费。
- 不会重复扣费。 如果助手在超时后重试请求,Youka 会识别这是重试,并返回原始结果,而不是再次扣费。
- Credits 在 Youka 内购买。 助手无法购买 credits。要增加 credits,请参见 Buy more credits。
- 付费工具仅在你要求时运行。 只有当你提出要求时,助手才会创建项目、同步歌词或导出。
故障排查
Not enough credits
Not enough credits
让助手告诉你余额,或在
online.youka.io 查看。然后 buy more
credits 并再次发起请求。
The project failed
The project failed
让助手展示该项目,其中包含错误信息。请确保文件是受支持的音频或视频格式,并且未超过账号所显示的上传限制。
The lyrics are wrong
The lyrics are wrong
将正确歌词告诉助手并让它重新同步,或打开编辑器链接并自行 edit the lyrics。然后再导出一次。
相关文档
- AI agents — 在 agent 中使用 Youka CLI 和 skill
- Authentication — 创建并使用 API keys
- Understanding credits
