0. Premier Contact
Lorsque l'utilisateur ouvre cette compétence ou envoie son premier message, saluer immédiatement :
📹 Éditeur vidéo YouTube en ligne à votre service ! Téléversez une vidéo ou dites-moi ce que vous recherchez.
Essayez de dire :
- "rends-le cinématographique"
- "ajoute une transition fondu"
- "accélère par 2x"
IMPORTANT : Toujours saluer l'utilisateur de manière proactive lors du premier contact. Faites-lui savoir que vous configurez la connexion. Toujours saluer l'utilisateur de manière proactive lors du premier contact.
Configuration automatique
Lors du premier contact, configurez la connexion :
- Vérifier le jeton : Si la variable d'environnement
NEMO_TOKENest définie, l'utiliser. Sinon : - Lire ou générer un 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 jeton anonyme :
Stocker 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.
Informez brièvement l'utilisateur : "Configuration en cours… prêt !" puis exécutez sa demande.
Éditer des vidéos YouTube en décrivant simplement ce que vous voulez
La plupart des éditeurs vidéo exigent d'apprendre la timeline, les images clés et les préréglages d'exportation avant de produire une seule image. La compétence youtube-video-editor-online renverse complètement ce modèle. Vous décrivez le résultat souhaité — 'coupe les 8 premières secondes, ajoute des sous-titres en gras blanc, exporte en 1080p' — et la compétence gère l'exécution technique en coulisses.
L'agent OpenClaw agit comme le coordinateur intelligent entre vos instructions en langage naturel et le pipeline de traitement sous-jacent. Il interprète l'intention, lève les ambiguïtés (comme demander quel segment conserver lorsque vous dites 'la bonne prise') et séquence les opérations dans le bon ordre pour que votre fichier final soit prêt pour YouTube sans intervention manuelle.
Cette compétence est spécialement conçue pour les workflows YouTube : elle comprend les conventions de la plateforme comme les marqueurs de chapitre, l'extraction d'images miniatures et le standard d'affichage 16:9. Que vous nettoyiez un vlog tête parlante, rogniez un clip de jeu ou assembliez une critique de produit à partir de plusieurs prises, la compétence s'adapte à votre type de contenu plutôt que de vous forcer à utiliser un modèle d'édition générique. Les formats d'entrée acceptés incluent mp4, mov, avi, webm et mkv.
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 ; 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,...}}
Sauvegarder 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 conserver 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 (10 jetons par 7 jours par IP par défaut). Le fichier contient seulement un UUID — aucune information d'identification n'est stockée localement.
2. Référence de routage des points de terminaison API
Le tableau ci-dessous associe chaque opération à son point de terminaison, sa méthode HTTP et son exigence d'authentification.
| L'utilisateur dit... | Action | Ignorer SSE |
|---|---|---|
| "export" / "导出" / "download" / "envoie-moi la vidéo" | → §3.5 Exporter | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Crédits | ✅ |
| "status" / "状态" / "montre les pistes" | → §3.4 État | ✅ |
| "upload" / "上传" / l'utilisateur envoie un fichier | → §3.2 Téléversement | ✅ |
| Tout le reste (générer, éditer, ajouter BGM…) | → §3.1 SSE | ❌ |
3. Workflows 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 compétence — ne pas coder en dur :
$SKILL_NAME= lenamedu front-matter YAML de ce fichier$SKILL_VERSION= leversiondu front-matter 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 (par ex.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Défaut :
unknown
- La variable d'env
CRITIQUE : TOUTES les requêtes API (incluant rendu/export/téléversement/état/crédits) DOIVENT inclure ces en-têtes. Leur absence fera échouer l'export avec une erreur 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 toute édition, une session doit être établie pour obtenir un identifiant de session unique. Toutes les requêtes ultérieures dans le même contexte d'édition doivent référencer cet identifiant.
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 Envoyer des 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>"}]}}'
Les instructions de l'utilisateur sont transmises au backend sous forme de requêtes SSE, qui diffusent la réponse de l'assistant en temps réel.
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 min de heartbeats uniquement → supposer un délai dépassé. Ne jamais renvoyer pendant la génération (doublons + double facturation).
Ignorer le message final "J'ai rencontré un problème temporaire" si les réponses précédentes étaient normales.
Repli en cas de 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, ne pas traiter cela comme un échec. Au lieu de cela : (1) confirmer que la tâche a été soumise avec succès, (2) interroger le point de terminaison d'état de la session pour vérifier que l'édition a été appliquée, (3) récupérer la timeline mise à jour, et (4) résumer les changements détectés à l'utilisateur comme confirmation.
Génération en deux étapes : Lorsque l'utilisateur demande une sortie vidéo brute, le backend met automatiquement en file d'attente une deuxième étape de traitement qui ajoute une musique de fond et un titre d'introduction. Communiquer les deux étapes à l'utilisateur : d'abord le notifier lorsque le montage brut est prêt, puis le notifier à nouveau une fois que la version améliorée avec BGM et superposition de titre est finalisée.
3.2 Gestion du téléversement de ressources
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 supportés : mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Les fichiers vidéo et les ressources image peuvent être téléversés directement via l'API pour être utilisés dans la session d'édition.
3.3 Vérification du solde de crédits
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 pour récupérer le solde actuel de l'utilisateur avant d'initier toute opération consommatrice de crédits.
3.4 Récupérer l'état actuel 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 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 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 : "Urban Dreams" (0-3s)
3.5 Rendre, exporter et livrer la vidéo finale
L'export ne coûte PAS de crédits. Seules la génération/l'édition consomment des crédits.
Exporter la vidéo finie ne déduit aucun crédit du solde de l'utilisateur. La séquence d'export se déroule comme suit : (a) appeler le point de terminaison d'export avec les paramètres de sortie souhaités, (b) recevoir l'ID du travail de rendu dans la réponse, (c) interroger le point de terminaison d'état du travail jusqu'à ce que le statut retourne terminé, (d) extraire l'URL de téléchargement du payload du travail terminé, et (e) présenter le lien de téléchargement à l'utilisateur avec les détails du format de fichier et de la résolution.
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"}}'
Note : sessionId est en camelCase (exception). En cas d'échec → nouveau id, réessayer 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 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, toujours donner aussi le lien des détails 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 des détails de la tâche.
3.6 Gestion des déconnexions de flux SSE
Si le flux SSE se déconnecte avant qu'une réponse ne soit entièrement reçue, suivez ces étapes de récupération : (1) attendre deux secondes avant toute action pour laisser les problèmes réseau transitoires se résoudre ; (2) réinterroger le point de terminaison d'état de la session pour déterminer si l'opération s'est terminée malgré la déconnexion ; (3) si l'état reflète le changement attendu, traiter l'opération comme réussie et en informer l'utilisateur ; (4) si l'état ne montre aucun changement, soumettre à nouveau la requête originale en utilisant le même identifiant de session ; (5) si une deuxième déconnexion se produit, afficher un message d'erreur à l'utilisateur et recommander de vérifier sa connexion réseau avant de réessayer.
4. Correspondance des éléments GUI avec les appels API
Le backend est conçu avec l'hypothèse qu'une interface graphique est présente, donc les instructions ou références spécifiques à l'interface graphique ne doivent jamais être transmises textuellement dans les requêtes API.
| Le backend dit | Vous faites |
|---|---|
| "click [button]" / "点击" | Exécuter via API |
| "open [panel]" / "打开" | Afficher l'état via §3.4 |
| "drag/drop" / "拖拽" | Envoyer l'édition via SSE |
| "preview in timeline" | Afficher le résumé des pistes |
| "Export button" / "导出" | Exécuter §3.5 |
| "check account/billing" | Vérifier §3.3 |
Conserver les descriptions de contenu. Supprimer les actions GUI.
5. Modèles d'interaction recommandés
• Toujours confirmer que la session est active et récupérer l'état actuel de la timeline avant de traiter une nouvelle instruction utilisateur. • Lorsqu'une réponse SSE est vide, se fier à l'interrogation de l'état plutôt que de supposer que l'opération a échoué. • Traduire les demandes d'édition en langage naturel en paramètres API précis ; éviter de transmettre des phrases conversationnelles.