Claude peut demander la création d’une vidéo via un service connecté tel qu’AKOOL MCP. Dans ce processus, Claude Code envoie une tâche de conversion d’image en vidéo, vérifie son état et récupère le résultat. AKOOL effectue la génération vidéo. Claude fournit l’interface de conversation qui permet de décrire, d’examiner et de gérer la tâche.
Si vous souhaitez générer une vidéo IA depuis Claude, il faut comprendre que Claude n’est pas le modèle de rendu. La plateforme de création vidéo IA AKOOL fournit les outils de génération via sa connexion Model Context Protocol.
En bref
- Connexion : ajoutez le serveur AKOOL MCP à Claude Code à l’aide de votre Client ID et de votre Client Secret AKOOL.
- Préparation : assurez-vous que l’image source approuvée est accessible au processus avant de soumettre une génération.
- Génération : découvrez d’abord les outils et les modèles, puis soumettez une seule
video_image2video_createtâche et conservez son identifiant. - Sauvegarde : interrogez la tâche existante avec
video_image2video_results, puis enregistrez la vidéo terminée au lieu de soumettre à nouveau la demande.
Sommaire
- Claude peut-il générer des vidéos ?
- Que faut-il pour générer des vidéos avec Claude Code ?
- Comment connecter le serveur AKOOL MCP ?
- Comment se déroule une tâche MCP de conversion d’image en vidéo ?
- Quels prompts vidéo utiliser avec Claude ?
- Comment résoudre les problèmes d’automatisation vidéo IA ?
- Comment fonctionnent les crédits et le choix du modèle ?
- Questions fréquentes
Claude peut-il générer des vidéos ?
Claude peut lancer une génération vidéo lorsqu’il est connecté à un service de rendu via MCP. Dans ce processus, Claude Code interprète votre demande, le Model Context Protocol relie Claude aux outils AKOOL et AKOOL effectue la conversion d’image en vidéo. Claude vérifie ensuite la tâche asynchrone et renvoie le résultat terminé.
| Layer | Role | What it does |
|---|---|---|
| Claude Code | Client and conversational interface | Understands your instruction and invokes tools |
| Model Context Protocol | Connection layer | Exposes AKOOL functions as tools Claude can discover and call |
| AKOOL | Generation service | Runs the image-to-video job and returns its result |
La documentation MCP officielle d’AKOOL expose actuellement, entre autres outils, account_models, account_credit, video_image2video_create et video_image2video_results. Pour découvrir d’autres intégrations, consultez les serveurs MCP pour la génération vidéo IA.
Que faut-il pour générer des vidéos avec Claude Code ?
Vous avez besoin de Claude Code, d’un compte AKOOL avec des identifiants API valides, de suffisamment de crédits AKOOL pour la génération choisie et d’une image source approuvée accessible au processus connecté. L’accès à Claude et le paiement de la génération AKOOL sont distincts.
Préparez quatre éléments :
- Claude Code. Ce guide utilise Claude Code, et non Claude Desktop.
- Client ID et Client Secret AKOOL. AKOOL utilise les en-têtes
x-client-idetx-client-secretpour l’authentification MCP. - Crédits de génération. Utilisez
account_creditpour consulter votre solde AKOOL. - Une image source approuvée. Utilisez une image qui vous appartient ou que vous êtes autorisé à transformer.
Pour préparer une ressource source adaptée, consultez le processus de conversion d’image en vidéo d’AKOOL.
Une photo de produit nette constitue un bon premier test, car elle donne un critère de réussite simple : le produit reste-t-il reconnaissable pendant le mouvement de caméra demandé ?
Comment connecter le serveur AKOOL MCP ?
Utilisez la procédure Claude Code documentée par AKOOL. Le point de terminaison du serveur est https://openapi.akool.com/mcp/v1, avec authentification par les en-têtes x-client-id et x-client-secret. Ne placez aucun de ces identifiants dans les prompts, captures d’écran, dépôts ou documents publiés.
Installez Claude Code si nécessaire :
npm install -g @anthropic-ai/claude-code
Ajoutez ensuite le serveur AKOOL MCP. Voici une version de la commande documentée par AKOOL qui protège les identifiants :
claude mcp add akool-mcp https://openapi.akool.com/mcp/v1 \
--header "x-client-id: $AKOOL_CLIENT_ID" \
--header "x-client-secret: $AKOOL_CLIENT_SECRET"
La documentation AKOOL recommande de conserver les secrets dans des variables d’environnement plutôt que de les enregistrer dans le gestionnaire de versions.
Vérifiez la connexion :
claude mcp list
Une entrée correspondant au serveur AKOOL devrait apparaître, par exemple :
akool-mcp http https://openapi.akool.com/mcp/v1
Consultez les instructions officielles de configuration AKOOL MCP pour obtenir la commande et les détails de configuration actuels. Ne copiez pas les identifiants dans une capture d’écran.
Comment se déroule une tâche MCP de conversion d’image en vidéo ?
Le processus le plus sûr sépare la découverte, la soumission, les vérifications d’état et la récupération. Une nouvelle génération peut consommer des crédits. Pour vérifier une tâche existante, réutilisez son identifiant au lieu de soumettre une nouvelle génération.
1. Découvrez les outils et modèles disponibles
Demandez à Claude :
Liste les outils AKOOL disponibles dans cette session. Identifie les outils de création et de récupération des résultats de conversion d’image en vidéo, et montre les entrées requises sans lancer de génération.
Recherchez video_image2video_create et video_image2video_results. AKOOL expose également account_models pour permettre à l’agent d’examiner les modèles disponibles pour le compte connecté.
2. Préparez l’image
Utilisez une image source stable, dont les droits sont vérifiés et le sujet clairement visible.
Exemple :
/product-assets/blue-bottle-approved.png
Ne vous fiez pas à un chemin local si Claude Code et l’outil concerné ne peuvent pas réellement y accéder.
3. Planifiez avant de soumettre
Demandez à Claude :
Utilise mon image de produit approuvée comme source. Prévois une courte séquence avec une lente avancée de caméra et un produit immobile. Présente le modèle proposé, les réglages pris en charge et les informations de coût disponibles avant la soumission.
Il s’agit d’une étape de planification. Elle ne doit pas lancer de génération payante.
4. Soumettez une seule tâche
Après avoir vérifié la proposition :
Soumets une seule fois la demande convenue de conversion d’image en vidéo. Utilise un mouvement de caméra doux, garde le produit immobile et renvoie l’identifiant de tâche.
AKOOL documente video_image2video_create comme outil de création.
Conservez immédiatement l’identifiant renvoyé :
Task ID: [SAVED_TASK_ID]
5. Interrogez la même tâche
Demandez :
Vérifie la tâche existante à l’aide de son identifiant enregistré. Indique si elle est en file d’attente, en cours de traitement, terminée ou en échec. Ne crée aucune autre tâche.
AKOOL précise que de nombreux outils MCP sont asynchrones et utilisent des outils de résultats pour vérifier leur achèvement.
6. Enregistrez le résultat
Une fois la tâche terminée :
Renvoie le lien de la vidéo terminée et son emplacement de sauvegarde. Compare-la à l’image source. Propose une modification de mouvement pour un nouvel essai, en conservant le résultat initial.
Voici un cycle de vie simple :
account_models
↓
video_image2video_create
↓
[SAVED_TASK_ID]
↓
video_image2video_results
↓
queued → processing → complete
↓
[RESULT_URL]
Quels prompts vidéo utiliser avec Claude ?
Utilisez des prompts qui explicitent l’état de la tâche. La principale distinction de sécurité consiste à déterminer si l’instruction examine simplement la session ou crée une nouvelle génération payante.
| Prompt | What it does | New generation? |
|---|---|---|
| 1. Discovery | Inspects tools and required inputs | No |
| 2. Planning | Reviews model/settings before submission | No |
| 3. Generation | Submits the image-to-video task | Yes |
| 4. Status | Checks the saved task | No |
| 5. Save and revise | Retrieves output and proposes a revision | No, unless you approve another run |
Prompt 1 : découverte
Liste les outils AKOOL disponibles dans cette session. Identifie les outils de création et de récupération des résultats de conversion d’image en vidéo, et montre les entrées requises sans lancer de génération.
Prompt 2 : planification
Utilise mon image de produit approuvée comme source. Prévois une courte séquence avec une lente avancée de caméra et un produit immobile. Présente le modèle proposé, les réglages pris en charge et les informations de coût disponibles avant la soumission.
Prompt 3 : génération
Soumets une seule fois la demande convenue de conversion d’image en vidéo. Utilise un mouvement de caméra doux, garde le produit immobile et renvoie l’identifiant de tâche.
Prompt 4 : état
Vérifie la tâche existante à l’aide de son identifiant enregistré. Indique si elle est en file d’attente, en cours de traitement, terminée ou en échec. Ne crée aucune autre tâche.
Prompt 5 : sauvegarde et révision
Renvoie le lien de la vidéo terminée et son emplacement de sauvegarde. Compare-la à l’image source. Propose une modification de mouvement pour un nouvel essai, en conservant le résultat initial.
Ces prompts vidéo pour Claude séparent délibérément la planification de l’exécution. C’est utile dans tout processus d’automatisation vidéo IA où une deuxième soumission accidentelle peut consommer des crédits supplémentaires.
Comment résoudre les problèmes d’automatisation vidéo IA ?
Vérifiez la tâche actuelle et l’état de la connexion avant toute nouvelle soumission. De nombreux échecs sont liés à l’authentification, à l’accès aux fichiers ou à l’état asynchrone, et ne justifient pas de créer une nouvelle génération.
| Symptom | First check | Next action |
|---|---|---|
| AKOOL tools are missing | claude mcp list | Recheck MCP setup and restart Claude Code |
| Authentication fails | Client ID and secret | Verify credentials in AKOOL dashboard |
401 Unauthorized | MCP headers | Replace invalid credentials |
| Source image cannot be used | File accessibility | Move or upload the asset somewhere the workflow can access |
| Job stays queued | Saved task ID | Poll the same job later |
| Result says failed | Existing result response | Read the failure before changing inputs |
| No download available | Job status | Confirm task is actually complete |
| Download link expired | Stored output/state | Retrieve a fresh available result rather than blindly regenerate |
| Two jobs appear | Task history | Confirm whether generation was submitted twice |
AKOOL documente explicitement 401 Unauthorized comme une raison de vérifier les identifiants du compte.
Comment fonctionnent les crédits et le choix du modèle ?
Utilisez les outils de modèles et de crédits du compte connecté plutôt que de supposer que tous les modèles du site AKOOL sont disponibles pour la tâche MCP actuelle. La disponibilité dépend du compte connecté et du schéma de l’outil, tandis que le coût de génération peut varier selon le modèle et les réglages.
Utilisez :
account_modelspour découvrir les modèles disponibles.account_creditpour vérifier le solde de crédits actuel.- Les réglages ou le devis renvoyés par l’outil de conversion d’image en vidéo, lorsqu’ils sont disponibles, pour comprendre la tâche à venir.
L’interface habituelle Image-to-Video d’AKOOL indique également que les tarifs diffèrent selon les modèles.
Ne prenez pas une réponse API ayant déduit un certain nombre de crédits pour la publier comme coût universel de la génération vidéo avec Claude Code. Le modèle, la résolution, la durée, le compte et les tarifs actuels peuvent varier.
De même, la plateforme principale AKOOL propose un catalogue de modèles plus large, mais cela ne prouve pas que chaque modèle est exposé dans chaque processus MCP.
Générez votre première vidéo avec Claude Code
Le principe utile est simple : découvrir → planifier → soumettre une seule fois → enregistrer l’identifiant de tâche → interroger → récupérer.
Cela facilite le débogage du processus de génération vidéo MCP et réduit le risque de confondre une vérification d’état avec une deuxième génération payante.
Pour explorer directement les mêmes fonctionnalités de génération, ouvrez la plateforme de création vidéo IA d’AKOOL. Pour les détails de configuration, consultez la documentation officielle AKOOL MCP.
