Passer au contenu principal
Youka dispose d’un serveur MCP. MCP (Model Context Protocol) est la méthode standard permettant aux assistants IA de se connecter à des outils externes. Une fois connecté, vous pouvez demander à votre assistant des choses comme « make a karaoke video of ~/Music/song.mp3 » et il crée le projet dans votre compte Youka, attend la fin du traitement, puis vous donne le lien de l’éditeur ou un lien de téléchargement. Le serveur fonctionne avec n’importe quel client MCP qui prend en charge les serveurs distants (Streamable HTTP) avec un en-tête personnalisé, comme Claude Code, Cursor et Codex.
Les applications officielles Youka pour ChatGPT et Claude arrivent bientôt. En attendant, utilisez un client de cette page avec une clé API Youka.

Ce dont vous avez besoin

Détails du serveur :
Votre clé API donne un accès complet à votre compte Youka et à ses crédits. Ne la mettez pas dans des fichiers ou dépôts partagés. Si une clé fuit, supprimez-la depuis la page de votre compte et créez-en une nouvelle.

Connecter votre assistant

Exécutez ceci dans votre terminal en remplaçant YOUR_API_KEY par votre clé :
Vérifiez que la connexion est bien établie :
Vous devriez voir youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected.Par défaut, le serveur n’est ajouté que pour le dossier courant. Ajoutez --scope user pour utiliser Youka dans tous les dossiers.

Essayer

Parlez à votre assistant en langage naturel. Par exemple :
Une demande typique de karaoké se déroule comme suit :
1

Upload

L’assistant demande à Youka un lien d’upload et envoie votre fichier. L’upload est gratuit.
2

Check the cost

Il vérifie combien de crédits le projet utilisera et compare avec votre solde.
3

Create the project

Youka supprime les voix et synchronise les paroles. Cela prend quelques minutes. L’assistant vérifie l’état jusqu’à ce que le projet soit prêt.
4

Edit or export

Vous recevez un lien pour ouvrir le projet dans l’éditeur Youka. Si vous demandez le fichier vidéo, l’assistant l’exporte et vous donne un lien de téléchargement.
Créer un projet ne rend jamais une vidéo à lui seul. Vous décidez quand exporter, afin de pouvoir d’abord corriger les paroles ou le style, soit dans le chat soit dans l’éditeur Youka.

Ce que l’assistant peut faire

Crédits et sécurité

  • Les mêmes crédits que l’application web. Créer un projet, resynchroniser les paroles et exporter coûtent la même chose que sur online.youka.io.
  • Le coût est vérifié d’abord. Si vous n’avez pas assez de crédits, Youka refuse la demande et le précise. Rien n’est facturé.
  • Pas de double facturation. Si l’assistant réessaie une requête après un timeout, Youka reconnaît la relance et renvoie le résultat d’origine au lieu de facturer à nouveau.
  • Les crédits s’achètent sur Youka. L’assistant ne peut pas acheter de crédits. Pour en ajouter, voir Buy more credits.
  • Les outils payants ne s’exécutent que lorsque vous le demandez. L’assistant est configuré pour ne créer des projets, resynchroniser les paroles ou exporter que lorsque vous le demandez.

Dépannage

La clé API est manquante ou invalide. Vérifiez que l’en-tête est exactement Authorization: Bearer yk_..., avec un seul espace après Bearer et sans espaces supplémentaires ni guillemets dans la clé. Si vous avez supprimé la clé depuis la page de votre compte, créez-en une nouvelle et mettez à jour votre client. Pour les configurations Codex et Cursor qui lisent YOUKA_API_KEY, assurez-vous que la variable est définie dans l’environnement depuis lequel l’application démarre.
Demandez à l’assistant votre solde, ou vérifiez-le sur online.youka.io. Ensuite buy more credits et réessayez.
Demandez à l’assistant d’afficher le projet. Il inclut l’erreur. Assurez-vous que le fichier est un fichier audio ou vidéo pris en charge et qu’il respecte les limites d’upload indiquées par votre compte.
Donnez à l’assistant les paroles correctes et demandez-lui de les synchroniser à nouveau, ou ouvrez le lien de l’éditeur et modifiez les paroles vous-même. Ensuite, exportez à nouveau.

Documentation associée