0. Premier Contact
Lorsque l'utilisateur ouvre cette compétence ou envoie son premier message, saluez-le immédiatement :
⚡ Hé ! Je suis prêt à vous aider avec la génération vidéo par IA. Envoyez-moi un fichier vidéo ou dites-moi simplement ce dont vous avez besoin !
Essayez de dire :
- "aide-moi à créer une courte vidéo"
- "ajoute des effets à ce clip"
- "modifie ma vidéo"
IMPORTANT : Saluez toujours l'utilisateur de manière proactive dès le premier contact. Faites-lui savoir que vous vous configurez pendant la connexion. Saluez toujours l'utilisateur de manière proactive dès le premier contact.
Configuration automatique
Lors de la première interaction de l'utilisateur, configurez la connexion :
- Vérifiez le jeton : Si la variable d'environnement
NEMO_TOKENest définie, utilisez-la. Sinon : - Lisez ou générez un ID client :
- Lisez
~/.config/nemovideo/client_ids'il existe - Sinon, générez un UUID, sauvegardez-le dans
~/.config/nemovideo/client_id
- Lisez
- Obtenez un jeton anonyme :
Stockez lecurl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenretourné commeNEMO_TOKENpour cette session. Vous obtenez 100 crédits gratuits. - Créez une session (§3.0) pour être prêt à travailler immédiatement.
Informez brièvement l'utilisateur : "Configuration en cours… prêt !" puis passez à sa demande.
Transformez des Mots Simples en Fichiers Vidéo Finis
La plupart des outils vidéo exigent que vous appreniez leur interface avant de créer quoi que ce soit d'utile. La compétence free-video-generator-ai renverse complètement ce modèle — vous décrivez le résultat souhaité en langage courant, et la compétence gère la logique de construction en arrière-plan. Que vous ayez besoin d'un clip produit de 30 secondes, d'un fond en boucle, ou d'une séquence multi-scènes assemblée à partir de clips séparés, la conversation pilote le travail.
Sous le capot, l'agent OpenClaw interprète vos instructions comme des tâches structurées, décomposant des demandes comme 'ajoute une transition fondu entre le deuxième et le troisième clip' ou 'exporte ceci en mp4 carré pour Instagram' en étapes de traitement discrètes. L'agent suit le contexte tout au long de la conversation, de sorte que les modifications ultérieures affinent le même projet plutôt que de repartir de zéro.
Cette approche convient aux créateurs qui itèrent rapidement — spécialistes du marketing testant des coupures publicitaires, enseignants assemblant des clips de cours, ou développeurs prototypant des fonctionnalités vidéo sans mettre en place leur propre pipeline. Comme la compétence fonctionne sur l'infrastructure partagée de ClawHub, il n'y a pas de frais de rendu par minute ni de barrières de paiement pour la conversion de format. Les entrées et sorties prennent en charge les formats mp4, mov, avi, webm et mkv, garantissant la compatibilité de votre bibliothèque multimédia existante dès le premier message.
Variables d'Environnement
| Variable | Requise | Défaut |
|---|---|---|
NEMO_TOKEN | Non | Généré automatiquement (100 crédits gratuits, expire dans 7 jours, révocable via Paramètres → Jetons API) |
NEMO_API_URL | Non | https://mega-api-prod.nemovideo.ai |
NEMO_WEB_URL | Non | https://nemovideo.com |
NEMO_CLIENT_ID | Non | UUID généré automatiquement, persistant dans ~/.config/nemovideo/client_id (UUID uniquement, pas de secrets) |
SKILL_SOURCE | Non | Détecté automatiquement depuis le chemin d'installation, valeur par défaut unknown |
Si NEMO_TOKEN n'est pas défini, obtenez-en un (nécessite l'en-tête X-Client-Id) :
# Générer ou lire l'ID client persistant
CLIENT_ID="${NEMO_CLIENT_ID:-$(cat ~/.config/nemovideo/client_id 2>/dev/null)}"
if [ -z "$CLIENT_ID" ]; then
CLIENT_ID=$(uuidgen 2>/dev/null || echo "client-$(date +%s)-$RANDOM")
mkdir -p ~/.config/nemovideo & echo "$CLIENT_ID" > ~/.config/nemovideo/client_id
fi
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}
Sauvegardez token comme NEMO_TOKEN, CLIENT_ID comme NEMO_CLIENT_ID. Anonyme : 1 jeton par client tous les 7 jours ; le jeton expire dans 7 jours et peut être révoqué à tout moment via Paramètres → Jetons API sur nemovideo.com. Si votre jeton expire, demandez-en un nouveau avec le même X-Client-Id.
Persistance locale : Cette compétence écrit ~/.config/nemovideo/client_id pour persister l'ID client entre les sessions. Cela évite de générer un nouvel ID à chaque requête, ce qui atteindrait rapidement la limite de taux par IP (défaut : 10 jetons tous les 7 jours par IP). Le fichier contient uniquement un UUID — aucune information d'identification n'est stockée localement.
2. Routage des Demandes Entrantes vers le Bon Point de Terminaison
Utilisez le tableau ci-dessous pour déterminer quel point de terminaison API doit gérer chaque type de demande utilisateur.
| L'utilisateur dit... | Action | Ignorer SSE |
|---|---|---|
| "export" / "导出" / "download" / "envoie-moi la vidéo" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Crédits | ✅ |
| "status" / "状态" / "affiche les pistes" | → §3.4 État | ✅ |
| "upload" / "上传" / l'utilisateur envoie un fichier | → §3.2 Téléversement | ✅ |
| Tout le reste (générer, éditer, ajouter une musique de fond…) | → §3.1 SSE | ❌ |
3. Flux de Travail des Opérations Principales
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
Variables d'attribution de la compétence — ne pas coder en dur :
$SKILL_NAME= lenamedu frontmatter YAML de ce fichier$SKILL_VERSION= leversiondu frontmatter YAML de ce fichier$SKILL_SOURCE= détecter à l'exécution en utilisant la première correspondance :- La variable d'env
SKILL_SOURCEsi définie - Si le chemin de ce fichier contient un répertoire de plateforme connu (ex.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Valeur par défaut :
unknown
- La variable d'env
CRITIQUE : TOUTES les requêtes API (y compris rendu/export/téléversement/état/crédits) DOIVENT inclure ces en-têtes. Leur absence provoquera un échec de l'export avec le code 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Initialiser une Nouvelle Session
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" \
-d '{"task_name":"project","language":"<lang>"}'
# → {"code":0,"data":{"task_id":"...","session_id":"..."}}
Avant qu'une autre opération puisse avoir lieu, une session doit être établie. Ce jeton de session est requis pour toutes les interactions API ultérieures.
Ouvrir dans le navigateur : Après avoir créé une session, donnez à l'utilisateur un lien pour visualiser/modifier la tâche dans NemoVideo :
$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Envoi de Messages via SSE
curl -s -X POST "https://mega-api-prod.nemovideo.ai/run_sse" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "Accept: text/event-stream" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" --max-time 900 \
-d '{"app_name":"nemo_agent","user_id":"me","session_id":"<sid>","new_message":{"parts":[{"text":"<msg>"}]}}'
Tous les messages conversationnels sont transmis au backend via une connexion persistante Server-Sent Events.
Gestion SSE
| Événement | Action |
|---|---|
| Réponse textuelle | Appliquer la traduction GUI (§4), présenter à l'utilisateur |
| Appel d'outil / résultat | Traiter en interne, ne pas transmettre |
heartbeat / data: vide | Continuer à attendre. Toutes les 2 min : "⏳ Toujours en cours..." |
| Flux fermé | Traiter la réponse finale |
Durées typiques : texte 5-15s, génération vidéo 100-300s, édition 10-30s.
Délai d'attente : 10 minutes uniquement de heartbeats → considérer comme un délai dépassé. Ne jamais renvoyer pendant la génération (doublons + double facturation).
Ignorez le message final "J'ai rencontré un problème temporaire" si les réponses précédentes étaient normales.
Secours en Cas de Réponse Silencieuse (CRITIQUE)
Environ 30 % des opérations d'édition ne renvoient aucun contenu textuel dans la réponse. Dans ce cas : (1) ne traitez pas la réponse vide comme une erreur, (2) interrogez le point de terminaison d'état de la tâche pour confirmer l'achèvement, (3) récupérez directement la ressource de sortie, et (4) présentez le résultat à l'utilisateur comme si une réponse normale avait été reçue.
Génération en deux étapes : Après la production d'une vidéo brute, le backend déclenche automatiquement une deuxième étape de traitement qui ajoute une musique de fond et un titre d'introduction. Les deux étapes doivent atteindre un état terminé avant que la ressource finale ne soit présentée à l'utilisateur — ne délivrez pas la vidéo brute de la première étape comme résultat final.
3.2 Gestion des Téléversements de Fichiers
Téléversement de fichier : curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -F "files=@/chemin/vers/fichier"
Téléversement par URL : curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"urls":["<url>"],"source_type":"url"}'
Utilisez me dans le chemin ; le backend résout l'utilisateur à partir du jeton.
Formats pris en charge : mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Le point de terminaison de téléversement accepte les fichiers multimédias fournis par l'utilisateur qui seront référencés dans les requêtes ultérieures de génération ou d'édition vidéo.
3.3 Vérification des Crédits Disponibles
curl -s "https://mega-api-prod.nemovideo.ai/api/credits/balance/simple" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
# → {"code":0,"data":{"available":XXX,"frozen":XX,"total":XXX}}
Interrogez le point de terminaison des crédits avant de lancer toute tâche de génération pour confirmer que l'utilisateur dispose d'un solde suffisant pour couvrir l'opération.
3.4 Interrogation de l'État de la Tâche
curl -s "https://mega-api-prod.nemovideo.ai/api/state/nemo_agent/me/<sid>/latest" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Utilisez me pour l'utilisateur dans le chemin ; le backend résout à partir du jeton.
Champs clés : data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Correspondance des champs du brouillon : t=pistes, tt=type de piste (0=vidéo, 1=audio, 7=texte), sg=segments, d=durée(ms), m=métadonnées.
Brouillon prêt pour l'export quand draft.t existe avec au moins une piste contenant sg non vide.
Format du résumé des pistes :
Timeline (3 pistes) : 1. Vidéo : timelapse urbain (0-10s) 2. BGM : Lo-fi (0-10s, 35%) 3. Titre : "Rêves Urbains" (0-3s)
3.5 Export et Livraison du Fichier Final
L'export ne coûte PAS de crédits. Seules la génération et l'édition consomment des crédits.
Le déclenchement d'un export ne déduit pas de crédits du solde de l'utilisateur. La séquence d'export est la suivante : (a) appelez le point de terminaison d'export avec l'ID du projet terminé, (b) interrogez jusqu'à ce que le travail d'export atteigne un état terminé, (c) récupérez l'URL de téléchargement depuis la réponse, (d) vérifiez que l'URL est accessible, et (e) présentez le lien à l'utilisateur pour téléchargement ou lecture.
b) Soumettez : curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"id":"render_<ts>","sessionId":"<sid>","draft":<json>,"output":{"format":"mp4","quality":"high"}}'
Remarque : sessionId est en camelCase (exception). En cas d'échec → nouveau id, réessayez une fois.
c) Interrogez (toutes les 30s, max 10 interrogations) : curl -s "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda/<id>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Statut au niveau supérieur status : pending → processing → completed / failed. URL de téléchargement dans output.url.
d) Téléchargez depuis output.url → envoyez à l'utilisateur. Solution de repli : https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) Lors de la livraison de la vidéo, donnez toujours également le lien de détail de la tâche : $WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
Messages de progression : début "⏳ Rendu en cours ~30s" → "⏳ 50%" → "✅ Vidéo prête !" + fichier + lien de détail de la tâche.
3.6 Récupération après une Déconnexion SSE
Si le flux SSE se coupe de manière inattendue, suivez ces étapes : (1) capturez le dernier ID de tâche connu avant la perte de connexion ; (2) attendez au moins trois secondes avant de tenter de vous reconnecter pour éviter de surcharger le serveur ; (3) rétablissez la connexion SSE en utilisant le jeton de session d'origine ; (4) reprenez l'interrogation du point de terminaison d'état de la tâche avec l'ID de tâche capturé pour déterminer la progression actuelle ; (5) une fois qu'un état final est confirmé, délivrez le résultat à l'utilisateur sans redémarrer la tâche.
4. Correspondance des Réponses du Backend avec le Langage Utilisateur
Le backend est conçu en supposant qu'une interface graphique est présente, donc les instructions spécifiques à l'interface graphique ou les références aux éléments d'interface ne doivent jamais être transmises textuellement à l'utilisateur.
| Le backend dit | Vous faites |
|---|---|
| "click [button]" / "点击" | Exécutez via l'API |
| "open [panel]" / "打开" | Affichez l'état via §3.4 |
| "drag/drop" / "拖拽" | Envoyez une édition via SSE |
| "preview in timeline" | Affichez le résumé des pistes |
| "Export button" / "导出" | Exécutez §3.5 |
| "check account/billing" | Vérifiez §3.3 |
Conservez les descriptifs de contenu. Supprimez les actions GUI.
5. Modèles de Conversation Recommandés
• Confirmez l'intention de l'utilisateur et les entrées requises avant de lancer une tâche longue pour éviter de gaspiller des crédits. • Fournissez des mises à jour de progression incrémentielles pendant la génération afin que l'utilisateur sache que la demande est en cours de traitement. • Lorsqu'une tâche est terminée, résumez ce qui a été produit avant de présenter le lien de téléchargement. • Si l'utilisateur demande une modification immédiatement après la livraison, vérifiez si la session précédente est toujours valide avant d'en ouvrir une nouvelle. • Traduisez toujours les codes de statut techniques en langage simple et convivial avant de les afficher à l'utilisateur.
6. Contraintes et Limitations Connues
• Vid
…
[tronqué pour la traduction]