Saltar para o conteúdo principal
O Youka tem um servidor MCP. O MCP (Model Context Protocol) é a forma padrão de assistentes de IA se conectarem a ferramentas externas. Depois de conectar, você pode pedir ao seu assistente coisas como “faça um vídeo de karaokê de ~/Music/song.mp3” e ele cria o projeto na sua conta do Youka, espera terminar e fornece o link do editor ou um link de download. O servidor funciona com qualquer cliente MCP que suporte servidores remotos (Streamable HTTP) com um cabeçalho personalizado, como Claude Code, Cursor e Codex.
Os apps oficiais do Youka para ChatGPT e Claude chegarão em breve. Até lá, use um cliente desta página com uma chave de API do Youka.

O que você precisa

Detalhes do servidor:
Sua chave de API dá acesso total à sua conta do Youka e aos créditos dela. Não a coloque em arquivos e repositórios compartilhados. Se uma chave vazar, exclua ela na página da sua conta e crie uma nova.

Conecte seu assistente

Execute isto no seu terminal, substituindo YOUR_API_KEY pela sua chave:
Verifique se conectou:
Você deve ver youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected.Por padrão, o servidor é adicionado apenas para a pasta atual. Adicione --scope user para usar o Youka em todas as pastas.

Experimente

Peça ao seu assistente em linguagem simples. Por exemplo:
Um pedido típico de karaokê funciona assim:
1

Upload

O assistente pede ao Youka um link de upload e envia seu arquivo. Fazer upload é grátis.
2

Check the cost

Ele verifica quantos créditos o projeto vai usar e compara com o seu saldo.
3

Create the project

O Youka remove os vocais e sincroniza as letras. Isso leva alguns minutos. O assistente verifica o status até o projeto ficar pronto.
4

Edit or export

Você recebe um link para abrir o projeto no editor do Youka. Se você pedir o arquivo de vídeo, o assistente exporta e fornece um link de download.
Criar um projeto nunca renderiza um vídeo por si só. Você decide quando exportar, então pode corrigir a letra ou o estilo antes, seja no chat ou no Youka editor.

O que o assistente pode fazer

Créditos e segurança

  • Mesmos créditos do app web. Criar um projeto, sincronizar letras novamente e exportar custam o mesmo que em online.youka.io.
  • O custo é verificado primeiro. Se você não tiver créditos suficientes, o Youka recusa a solicitação e informa isso. Nada é cobrado.
  • Sem cobranças duplicadas. Se o assistente repetir uma solicitação após um timeout, o Youka reconhece a repetição e retorna o resultado original em vez de cobrar novamente.
  • Os créditos são comprados no Youka. O assistente não pode comprar créditos. Para adicionar mais, veja Buy more credits.
  • Ferramentas pagas só rodam quando você pede. O assistente é instruído a criar projetos, sincronizar letras ou exportar somente quando você solicitar.

Solução de problemas

A chave de API está ausente ou é inválida. Verifique se o cabeçalho é exatamente Authorization: Bearer yk_..., com um espaço após Bearer e sem espaços extras ou aspas dentro da chave. Se você excluiu a chave na página da sua conta, crie uma nova e atualize seu cliente. Para configurações do Codex e do Cursor que leem YOUKA_API_KEY, verifique se a variável está definida no ambiente a partir do qual o app é iniciado.
Peça ao assistente seu saldo ou verifique em online.youka.io. Depois buy more credits e peça novamente.
Peça ao assistente para mostrar o projeto. Ele inclui o erro. Verifique se o arquivo é um áudio ou vídeo suportado dentro dos limites de upload mostrados pela sua conta.
Diga ao assistente as letras corretas e peça para sincronizá-las novamente, ou abra o link do editor e edit the lyrics você mesmo. Depois exporte novamente.

Documentos relacionados