Official Youka apps for ChatGPT and Claude are coming soon. Until then, use a
client from this page with a Youka API key.
What you need
- A Youka account with credits. The MCP server uses the same credits as the web app. See Understanding credits.
- A Youka API key. Create one at online.youka.io/account under API keys. See Authentication.
Connect your assistant
- Claude Code
- Cursor
- Codex
- Other clients
Run this in your terminal, replacing Check that it connected:You should see
YOUR_API_KEY with your key:youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected.By default the server is added for the current folder only. Add --scope user to use Youka in every folder.Try it
Ask your assistant in plain language. For example:1
Upload
The assistant asks Youka for an upload link and uploads your file. Uploading
is free.
2
Check the cost
It checks how many credits the project will use and compares that with your
balance.
3
Create the project
Youka removes the vocals and syncs the lyrics. This takes a few minutes. The
assistant checks the status until the project is ready.
4
Edit or export
You get a link to open the project in the Youka editor. If you ask for the
video file, the assistant exports it and gives you a download link.
What the assistant can do
Credits and safety
- Same credits as the web app. Creating a project, syncing lyrics again, and exporting cost the same as they do on online.youka.io.
- Cost is checked first. If you don’t have enough credits, Youka refuses the request and says so. Nothing is charged.
- No double charges. If the assistant retries a request after a timeout, Youka recognizes the retry and returns the original result instead of charging again.
- Credits are bought on Youka. The assistant can’t buy credits. To add more, see Buy more credits.
- Paid tools run only when you ask. The assistant is told to create projects, sync lyrics, or export only when you ask for it.
Troubleshooting
Not enough credits
Not enough credits
Ask the assistant for your balance, or check it on
online.youka.io. Then buy more
credits and ask again.
The project failed
The project failed
Ask the assistant to show the project. It includes the error. Make sure the
file is a supported audio or video file within the upload limits shown by
your account.
The lyrics are wrong
The lyrics are wrong
Tell the assistant the correct lyrics and ask it to sync them again, or open
the editor link and edit the lyrics yourself. Then
export again.
Related docs
- AI agents — use the Youka CLI and skill from an agent
- Authentication — create and use API keys
- Understanding credits
