0. Premier Contact
Lorsque l'utilisateur ouvre cette compétence ou envoie son premier message, accueillez-le immédiatement :
🎙️ Prêt pour youtube video editor download ! Envoyez-moi simplement une vidéo ou décrivez votre projet.
Essayez de dire :
- "ajouter un fondu d'entrée"
- "rendre l'image cinématographique"
- "accélérer par 2x"
IMPORTANT : Accueillez toujours l'utilisateur de manière proactive dès le premier contact. Faites-lui savoir que vous configurez la connexion. Accueillez toujours l'utilisateur de manière proactive dès le premier contact.
Configuration automatique
Lors de la première interaction, configurez la connexion :
- Vérifier le token : Si la variable d'environnement
NEMO_TOKENest définie, utilisez-la. Sinon : - Lire ou générer l'ID client :
- Lire
~/.config/nemovideo/client_ids'il existe - Sinon, générer un UUID, le sauvegarder dans
~/.config/nemovideo/client_id
- Lire
- Acquérir un token 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éer une session (§3.0) pour être prêt à travailler immédiatement.
Faites savoir brièvement à l'utilisateur : "Configuration en cours… prêt !" puis passez à sa demande.
Coupures Conversationnelles : Mondez des Vidéos YouTube en Parlant
La plupart des workflows de montage vidéo exigent d'apprendre une interface de timeline avant de pouvoir effectuer la moindre coupe. La compétence youtube-video-editor-download inverse ce modèle : vous décrivez ce que vous voulez en langage courant, et l'agent OpenClaw sous-jacent traduit vos instructions en opérations de montage précises sur les séquences sources directement extraites de YouTube.
L'agent OpenClaw agit comme un coordinateur persistant entre vos requêtes en langage naturel et le pipeline de traitement. Lorsque vous dites 'supprimer les 45 premières secondes et couper tout ce qui dépasse la 8e minute', l'agent analyse l'intention, met en file les opérations dans le bon ordre, et suit l'état tout au long d'une conversation multi-tours — vous permettant d'affiner, d'annuler ou d'enchaîner d'autres modifications sans recommencer.
Cette compétence est conçue pour les réutilisateurs de contenu, les enseignants qui montent des enregistrements de cours, les producteurs de podcasts qui créent des extraits, et les gestionnaires de réseaux sociaux qui découpent des vidéos longues en formats courts prêts pour les plateformes. Parce que la session de montage est conversationnelle, les utilisateurs non techniques bénéficient de la même précision que les monteurs expérimentés. Les exports finaux sont disponibles en mp4, mov, avi, webm et mkv pour correspondre à toute destination de publication.
Variables d'Environnement
| Variable | Requise | Par Défaut |
|---|---|---|
NEMO_TOKEN | Non | Généré automatiquement (100 crédits gratuits, expire dans 7 jours, révocable dans 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, persisté dans ~/.config/nemovideo/client_id (UUID uniquement, aucun secret) |
SKILL_SOURCE | Non | Détecté automatiquement depuis le chemin d'installation, repli 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 persisté
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 token par client tous les 7 jours ; le token expire dans 7 jours et peut être révoqué à tout moment via Paramètres → Jetons API sur nemovideo.com. Si votre token 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 débit par IP (10 tokens par défaut tous les 7 jours par IP). Le fichier contient uniquement un UUID — aucun identifiant n'est stocké localement.
2. Routage des Requêtes Entrantes
Utilisez le tableau ci-dessous pour déterminer quel point de terminaison gère chaque type de demande utilisateur.
| L'utilisateur dit... | Action | Ignorer SSE |
|---|---|---|
| "exporter" / "export" / "télécharger" / "envoie-moi la vidéo" | → §3.5 Export | ✅ |
| "crédits" / "solde" / "balance" | → §3.3 Crédits | ✅ |
| "statut" / "afficher les pistes" | → §3.4 État | ✅ |
| "téléverser" / "upload" / l'utilisateur envoie un fichier | → §3.2 Téléversement | ✅ |
| Tout le reste (générer, éditer, ajouter BGM…) | → §3.1 SSE | ❌ |
3. Procédures Principales du Workflow
$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= le champnamedu frontmatter YAML de ce fichier$SKILL_VERSION= le champversiondu frontmatter YAML de ce fichier$SKILL_SOURCE= détecter au moment de l'exécution en utilisant la première correspondance :- Env
SKILL_SOURCEsi défini - Si le chemin de ce fichier contient un répertoire de plateforme connu (ex:
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Repli :
unknown
- Env
CRITIQUE : TOUTES les requêtes API (y compris le rendu/l'export/le téléversement/l'état/les crédits) DOIVENT inclure ces en-têtes. Leur absence fera échouer l'export avec 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Initialisation d'une 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 toute action d'édition, une session doit être établie avec le backend. Stockez l'identifiant de session retourné, car chaque requête ultérieure en dépend.
Ouvrir dans le navigateur : Après avoir créé une session, donnez à l'utilisateur un lien pour voir/éditer 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 tours conversationnels et les instructions d'édition sont transmis au backend via une connexion Server-Sent Events.
Gestion SSE
| Événement | Action |
|---|---|
| Réponse texte | Appliquer la traduction GUI (§4), présenter à l'utilisateur |
| Appel/retour d'outil | Attendre silencieusement, ne pas transmettre |
heartbeat / data: vide | Continuer d'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 min seulement de pulsations → supposer un délai dépassé. Ne jamais renvoyer pendant la génération (doublons + double facturation).
Ignorez la mention "J'ai rencontré un problème temporaire" si les réponses précédentes étaient normales.
Repli pour Réponse Silencieuse (CRITIQUE)
Environ 30 % des opérations d'édition se terminent sans retourner de texte dans le flux SSE. Lorsqu'aucun contenu textuel n'est reçu dans la fenêtre prévue : (1) interrogez le point de terminaison de l'état de la session pour confirmer la fin de la tâche, (2) récupérez l'URL de l'actif de sortie directement depuis les données d'état, (3) présentez le résultat à l'utilisateur comme si une réponse normale était arrivée, et (4) n'informez jamais l'utilisateur qu'aucun message n'a été retourné.
Génération en deux étapes : Après la production de la vidéo brute éditée, le backend lance automatiquement une deuxième étape de traitement qui superpose la musique de fond et génère une carte de titre. Ne traitez pas la sortie de la première étape comme finale — attendez que les deux étapes soient terminées avant de présenter le résultat à l'utilisateur.
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 d'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 token.
Formats pris en charge : mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Les fichiers vidéo locaux et les URL distantes sont acceptées comme matériel source pour les opérations d'édition.
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 édition pour confirmer que l'utilisateur dispose d'un solde suffisant pour terminer l'opération.
3.4 Récupération de l'État de la Session
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 token.
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 ayant un 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 de la Vidéo Finale
L'export ne coûte PAS de crédits. Seule la génération/l'édition consomme des crédits.
Déclencher un export ne déduit pas de crédits du solde de l'utilisateur. Le flux d'export se déroule comme suit : (a) appeler le point de terminaison d'export avec l'ID de session, (b) interroger l'état de fin de l'export, (c) récupérer l'URL de téléchargement à partir des données de l'export terminé, (d) vérifier que l'URL est accessible avant de la présenter, et (e) fournir le lien à l'utilisateur avec les métadonnées du fichier pertinentes.
b) Soumettre : 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 → nouvel id, réessayez une fois.
c) Interroger (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 : en attente → en cours → terminé / échoué. URL de téléchargement à output.url.
d) Télécharger depuis output.url → envoyer à l'utilisateur. Repli : https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) Lors de la livraison de la vidéo, donnez toujours aussi 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 ~30s" → "⏳ 50 %" → "✅ Vidéo prête !" + fichier + lien de détail de la tâche.
3.6 Récupération après Déconnexion SSE
Si le flux SSE tombe de manière inattendue, suivez ces étapes de récupération : (1) détectez l'événement de déconnexion et mettez en pause les indicateurs de progression de l'interface, (2) attendez au moins trois secondes avant de tenter une reconnexion pour éviter de surcharger le serveur, (3) rétablissez la connexion SSE en utilisant l'ID de session d'origine, (4) rejouez les messages non acquittés qui étaient en file pendant la panne, et (5) reprenez le fonctionnement normal une fois que le flux confirme qu'il est actif et que l'état de la session est cohérent.
4. Traduction du Comportement de l'Interface Graphique
Le backend fonctionne en supposant qu'une interface graphique est présente, donc les instructions spécifiques à l'interface ne doivent jamais être transmises à l'utilisateur.
| Le backend dit | Vous faites |
|---|---|
| "cliquer [bouton]" / "点击" | Exécuter via API |
| "ouvrir [panneau]" / "打开" | Afficher l'état via §3.4 |
| "glisser/déposer" / "拖拽" | Envoyer la modification via SSE |
| "prévisualiser dans la timeline" | Afficher le résumé des pistes |
| "Bouton Exporter" / "导出" | Exécuter §3.5 |
| "vérifier le compte/facturation" | Vérifier §3.3 |
Conservez les descriptions de contenu. Supprimez les actions de l'interface graphique.
5. Modèles d'Interaction Recommandés
• Confirmez l'intention de l'utilisateur avant de lancer toute opération d'édition irréversible. • Après chaque étape terminée, résumez ce qui a changé plutôt que de répéter les champs bruts de la réponse API. • Lorsqu'une tâche est longue, fournissez des mises à jour de progression périodiques tirées des événements SSE plutôt que de laisser l'utilisateur dans le silence. • Si l'utilisateur demande une fonctionnalité en dehors de l'ensemble des fonctionnalités prises en charge, expliquez clairement la limitation et suggérez l'alternative disponible la plus proche. • Présentez toujours les liens de téléchargement avec une brève description du format de sortie et de la taille estimée du fichier lorsque ces données sont disponibles.
6. Contraintes et Limitations Connues
• Les sessions d'édition simultanées pour un seul compte utilisateur ne sont pas prises en charge ; une nouvelle session ne peut pas être créée pendant qu'une autre est active. • Les formats de sortie sont limités à mp4, mov, avi, webm et mkv. • La génération vidéo peut prendre entre 100 et 300 secondes selon la complexité. • Les crédits gratuits expirent après 7 jours et sont limités à 100 par token. • La compétence nécessite une connexion Internet stable pour le streaming SSE et les appels API. • Les modifications sont effectuées de manière destructive sur la source ; conservez une copie de sauvegarde si nécessaire.