Serveur MCP de génération vidéo IA

Qu’est-ce que le serveur MCP vidéo de VidFlux ?

Le Model Context Protocol (MCP) est le standard ouvert qu’utilisent les assistants IA pour appeler des outils externes. VidFlux MCP est un endpoint hébergé qui donne à votre assistant des outils de création vidéo : lancer une génération texte-vers-vidéo, image-vers-vidéo ou de contrôle du mouvement, suivre sa progression et récupérer le MP4 final. L’assistant rédige le prompt, choisit le modèle, la durée et le format, attend le rendu et vous remet le fichier sans que vous quittiez le chat ou l’éditeur.

Derrière l’endpoint tourne le même pipeline que le générateur vidéo de vidflux.ai : versions des modèles, tarifs et remboursements sont identiques, et chaque tâche apparaît aussi dans l’historique de votre compte.

Modèles vidéo IA disponibles

Indiquez l’identifiant du modèle dans l’argument model. Les crédits correspondent aux réglages par défaut ; une vidéo plus longue, en plus haute résolution ou avec audio coûte davantage. dry_run renvoie le prix exact pour n’importe quels réglages.

Modèles d’image pour images clés et miniatures

Créez ou retouchez des images de départ, des visuels produit et des miniatures, puis animez-les avec l’un des modèles image-vers-vidéo ci-dessus.

Démarrage rapide : connecté en 3 étapes

1. Connectez-vous à VidFlux et créez une clé dans Paramètres → API & MCP. Les nouveaux comptes reçoivent des crédits d’essai gratuits.
2. Ajoutez le serveur à votre client IA avec l’une des configurations ci-dessous.
3. Demandez une vidéo, par exemple : « Fais avec Seedance 2 une vidéo de 5 secondes en 9:16 d’un latte art versé au ralenti et enregistre-la dans ./assets ».

Configuration des clients MCP

Remplacez vf_your_api_key par votre clé. Pour les clients qui lisent les variables d’environnement, stockez plutôt la clé dans VIDFLUX_API_KEY que dans le fichier de configuration.

Claude Code

claude mcp add --transport http vidflux https://vidflux.ai/api/mcp \
  --header "Authorization: Bearer vf_your_api_key"

# verify
claude mcp list

Claude Desktop

Claude Desktop se connecte aux serveurs distants avec une clé API via mcp-remote (Node.js requis). Modifiez claude_desktop_config.json puis redémarrez Claude :

{
  "mcpServers": {
    "vidflux": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://vidflux.ai/api/mcp",
        "--header", "Authorization: Bearer vf_your_api_key"
      ]
    }
  }
}

Cursor

Ajoutez dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (un seul projet) :

{
  "mcpServers": {
    "vidflux": {
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

OpenAI Codex CLI

export VIDFLUX_API_KEY=vf_your_api_key
codex mcp add vidflux --url https://vidflux.ai/api/mcp \
  --bearer-token-env-var VIDFLUX_API_KEY

VS Code (GitHub Copilot agent mode)

Ajoutez dans .vscode/mcp.json :

{
  "servers": {
    "vidflux": {
      "type": "http",
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Windsurf

Ajoutez dans ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "vidflux": {
      "serverUrl": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Cline, Roo Code et autres clients

Tout client compatible avec les serveurs Streamable HTTP et les en-têtes personnalisés fonctionne avec la même URL et le même en-tête. Les clients limités à stdio peuvent utiliser la commande mcp-remote indiquée pour Claude Desktop.

Outils MCP

La génération vidéo est asynchrone. Un déroulé typique ressemble à ceci :

list_models            → seedance-2 (9:16, audio)
generate_video {model: "seedance-2", prompt: "...", aspect_ratio: "9:16",
                duration: 5, dry_run: true}
                       → {"credits_required": 425, "sufficient": true}
generate_video {...same arguments without dry_run}
                       → {"id": "3f1c9e0a-...", "status": "processing"}
get_task {task_id: "3f1c9e0a-..."}   (every 15 s)
                       → {"status": "completed", "video_url": "https://...mp4"}

Tarifs : crédits à l’usage

• La connexion au serveur et les appels à list_models, get_task et get_credits sont gratuits.
• Chaque vidéo coûte les mêmes crédits que sur vidflux.ai (voir les tableaux ci-dessus). Les packs commencent à 500 crédits pour 4,98 $, les gros packs reviennent moins cher par crédit, et les crédits achetés n’expirent pas.
• dry_run: true valide les arguments et renvoie le prix exact et si votre solde suffit, sans rien générer.
• Les tâches échouées ou refusées sont remboursées automatiquement.

Voir les packs de crédits et les offres

Ce que vous pouvez en faire

VidFlux MCP vs API des fournisseurs vs serveurs MCP auto-hébergés

Dépannage

Le serveur est connecté mais aucun outil vidéo n’apparaît

Redémarrez le client ou rechargez les serveurs MCP, et vérifiez que le mode Agent est activé (Cursor, VS Code). Dans Claude Code, /mcp affiche la liste des outils.

401 Unauthorized ou « Missing or invalid API key »

L’en-tête doit être exactement Authorization: Bearer vf_…. Vérifiez que la clé n’a pas été révoquée et qu’aucun guillemet ni espace n’a été copié en trop.

402 INSUFFICIENT_CREDITS

Votre solde est inférieur au prix renvoyé par dry_run. Rechargez des crédits ou choisissez une vidéo plus courte, une résolution plus basse ou un modèle moins cher.

Une vidéo reste longtemps en processing

La plupart des vidéos sont prêtes en 1 à 5 minutes ; les longues vidéos Seedance 2.5 ou Gemini Omni en 4K prennent plus de temps. Continuez d’interroger get_task. En cas d’échec, l’erreur est renvoyée et les crédits remboursés.

spawn npx ENOENT dans Claude Desktop

mcp-remote nécessite Node.js 18 ou plus. Installez Node.js ou indiquez le chemin complet de npx dans le champ command.

Les images de référence sont refusées

image_urls doit contenir des liens HTTPS publics vers des fichiers JPG, PNG ou WebP. Les chemins locaux et les liens protégés par une connexion ne peuvent pas être lus.

Questions fréquentes