Compétence de génération vidéo Medeo
Générez des vidéos IA à partir de texte. Medeo est un agent vidéo IA qui gère des scénarios complets, des récits multi-scènes et des screenplays en un seul appel — composition des plans, transitions, rythme et musique sont entièrement automatiques.
⚠️ Ne divisez PAS les histoires en plusieurs appels. Transmettez l'intégralité du screenplay dans un seul
--message.
0. Vérification pré-vol (OBLIGATOIRE — à exécuter avant toute autre chose)
Avant d'exécuter une commande, vérifiez si la clé API est configurée :
python3 {baseDir}/scripts/medeo_video.py config 2>/dev/null | python3 -c "import sys,json; d=json.load(sys.stdin); print('ok' if d.get('apiKey') else 'missing')"
- Sortie
ok→ procédez normalement - Sortie
missing(ou la commande échoue) → arrêtez immédiatement, n'exécutez AUCUNE autre commande. Envoyez le message de configuration en utilisant la méthode adaptée au canal :
Feishu — utilisez directement l'API Feishu (PAS l'outil message — il ne peut pas afficher les cartes) :
import json, urllib.request
cfg = json.loads(open("/home/ec2-user/.openclaw/openclaw.json").read())
feishu = cfg["channels"]["feishu"]["accounts"]["default"]
token = json.loads(urllib.request.urlopen(urllib.request.Request(
"https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
data=json.dumps({"app_id": feishu["appId"], "app_secret": feishu["appSecret"]}).encode(),
headers={"Content-Type": "application/json"}
)).read())["tenant_access_token"]
card = {
"config": {"wide_screen_mode": True},
"header": {"title": {"tag": "plain_text", "content": "🎬 Génération vidéo — Clé API requise"}, "template": "blue"},
"elements": [{"tag": "div", "text": {"tag": "lark_md", "content": "Vous avez besoin d'une **clé API Medeo** pour générer des vidéos.\n\n**Étapes :**\n1. Allez sur https://medeo.app/dev/apikey\n - Pas de compte ? Vous serez guidé pour vous inscrire. La clé apparaît après la connexion.\n2. Copiez la clé (commence par `mk_`) et renvoyez-la moi.\n\nUne fois que je l'aurai, je configurerai tout pour vous."}}],
}
urllib.request.urlopen(urllib.request.Request(
"https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id",
data=json.dumps({"receive_id": "<USER_OPEN_ID>", "msg_type": "interactive", "content": json.dumps(card)}).encode(),
headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
))
Telegram / Discord / Autres canaux — envoyez du texte brut via l'outil message (ces canaux prennent en charge le markdown nativement) :
🎬 Génération vidéo — Clé API requise
Étapes :
1. Allez sur https://medeo.app/dev/apikey (inscrivez-vous si nécessaire — la clé apparaît après la connexion)
2. Copiez la clé (commence par mk_) et renvoyez-la moi
Une fois que je l'aurai, je configurerai tout pour vous.
Une fois qu'ils fournissent la clé : python3 {baseDir}/scripts/medeo_video.py config-init --api-key "mk_..."
1. Configuration initiale
Si aucune clé API n'est configurée, le script affiche "setup_required": true.
- Envoyez à l'utilisateur ce lien exact : https://medeo.app/dev/apikey (cette page invite automatiquement à l'inscription si l'utilisateur n'est pas connecté, puis affiche la clé API)
- Une fois qu'ils fournissent la clé :
python3 {baseDir}/scripts/medeo_video.py config-init --api-key "mk_..."
2. Générer une vidéo (5-30 min, toujours asynchrone)
Les utilisateurs ont seulement besoin de connaître 3 façons de générer une vidéo :
- Envoyer du texte → générer une vidéo
- Envoyer du texte + télécharger une image → générer une vidéo en utilisant leur image
- Envoyer du texte + URL d'image → générer une vidéo en utilisant l'image par URL
L'agent gère tout le reste en silence.
IMPORTANT : Avant de lancer la tâche de génération, répondez immédiatement à l'utilisateur avec un accusé de réception comme : "🎬 Lancement de la génération vidéo — je vous enverrai le résultat dans environ 5 à 10 minutes." N'attendez pas en silence. L'utilisateur doit savoir que sa demande a été reçue.
Utilisation 1 : Texte uniquement
python3 {baseDir}/scripts/medeo_video.py spawn-task \
--message "description de la vidéo par l'utilisateur" \
--deliver-to "oc_xxx" \
--deliver-channel "feishu"
Utilisation 2 : Texte + image téléchargée (l'utilisateur envoie une image dans le chat)
# D'abord : upload-file pour obtenir le media_id (voir Section 3)
python3 {baseDir}/scripts/medeo_video.py spawn-task \
--message "description de la vidéo par l'utilisateur" \
--media-ids "media_01..." \
--asset-sources my_uploaded_assets \
--deliver-to "oc_xxx" \
--deliver-channel "feishu"
Utilisation 3 : Texte + URL d'image
python3 {baseDir}/scripts/medeo_video.py spawn-task \
--message "description de la vidéo par l'utilisateur" \
--media-urls "https://example.com/photo.jpg" \
--asset-sources my_uploaded_assets \
--deliver-to "oc_xxx" \
--deliver-channel "feishu"
Comportement automatique de l'agent : Lorsque l'utilisateur fournit des images (Utilisation 2 ou 3), passez toujours
--asset-sources my_uploaded_assetspour que Medeo utilise leurs images au lieu d'en générer de nouvelles. L'utilisateur n'a pas besoin de connaître ce paramètre.
Paramètres internes (usage agent uniquement — ne jamais exposer aux utilisateurs)
Ceux-ci sont gérés automatiquement par l'agent. Ne les mentionnez PAS aux utilisateurs et ne leur demandez PAS de les fournir.
| Indicateur | Quand l'utiliser | Comportement par défaut |
|---|---|---|
--voice-id "voice_01..." | Lorsqu'une voix spécifique est nécessaire | Medeo choisit automatiquement |
--video-style-id "style_01..." | Lorsqu'un style visuel spécifique est nécessaire | Medeo choisit automatiquement |
--asset-sources | Lorsque l'utilisateur fournit des images : passez my_uploaded_assets | Medeo décide |
--recipe-id "recipe_01..." | Lors de l'utilisation d'un modèle | Aucun |
--aspect-ratio "9:16" | Lorsque l'utilisateur spécifie portrait/paysage | 16:9 |
--duration-ms 30000 | Lorsque l'utilisateur spécifie la durée | Medeo décide |
--no-render | Débogage uniquement — ignorer le rendu | Toujours effectuer le rendu |
Cible de livraison (--deliver-to)
Ceci est critique — détermine où la vidéo générée est envoyée.
| Contexte | Valeur --deliver-to | Exemple |
|---|---|---|
| Groupe Feishu | Le chat_id du groupe (commence par oc_). Extrayez-le des métadonnées entrantes conversation_label ou chat_id — supprimez le préfixe chat: si présent (par ex. chat:oc_xxx → oc_xxx) | oc_158fd3e54407cbe170697c6c954bd4f2 |
| Chat privé Feishu | Le open_id de l'utilisateur (commence par ou_). Extrayez-le des métadonnées entrantes sender_id — supprimez le préfixe user: si présent | ou_f7f458f4d7b4ff49ec1b8de22a1e3206 |
| Telegram | Le chat_id du contexte du message entrant | -1001234567890 |
| Discord | Le channel_id du contexte du message entrant | 1234567890123456 |
Comment déterminer groupe vs privé sur Feishu :
- Vérifiez
is_group_chatdans les métadonnées entrantes - Si
true→ utilisezconversation_label/chat_id(la valeuroc_) - Si
false→ utilisezsender_id(la valeurou_)
Étape 2 : Utilisez sessions_spawn avec les arguments retournés (label: "medeo: <bref>", runTimeoutSeconds: 2400).
Étape 3 : Dites à l'utilisateur que la génération est en cours. Le sous-agent annonce automatiquement la fin.
3. Télécharger des actifs
3a. Depuis une URL (l'image a déjà une URL publique)
python3 {baseDir}/scripts/medeo_video.py upload \
--url "https://example.com/photo.jpg" \
--project-id "project_01..." # optionnel : associer le média à un projet existant
--no-wait # optionnel : retourner immédiatement le job_id sans attendre
3b. Depuis une pièce jointe IM (l'utilisateur envoie une image directement) ← NOUVEAU
Utilisez upload-file lorsque l'utilisateur envoie une image via Telegram, Discord, Feishu ou comme fichier local.
Cela utilise l'API de téléchargement direct (préparation → PUT présigné S3 → enregistrement) au lieu du téléchargement basé sur URL.
Déclencheur : Uniquement lorsque l'utilisateur demande explicitement la génération vidéo ET envoie une pièce jointe image dans le même message (par ex. "fais une vidéo avec cette photo"). Ne téléchargez PAS automatiquement chaque message image — d'autres compétences ou conversations peuvent impliquer des images sans rapport avec la génération vidéo.
# Depuis un fichier local (téléchargé par OpenClaw depuis la pièce jointe)
python3 {baseDir}/scripts/medeo_video.py upload-file \
--file /tmp/user_photo.jpg
# Depuis une URL directe (CDN Discord, etc.)
python3 {baseDir}/scripts/medeo_video.py upload-file \
--url "https://cdn.discordapp.com/attachments/..."
# Depuis Telegram (file_id depuis message.photo[-1].file_id)
# TELEGRAM_BOT_TOKEN doit être défini comme variable d'environnement — ne jamais passer comme argument CLI (ps aux le fuit)
TELEGRAM_BOT_TOKEN="$TELEGRAM_BOT_TOKEN" python3 {baseDir}/scripts/medeo_video.py upload-file \
--telegram-file-id "AgACAgIAAxk..."
# Depuis Feishu (message_id + image_key depuis le contenu du message)
python3 {baseDir}/scripts/medeo_video.py upload-file \
--feishu-message-id "om_xxx" \
--feishu-image-key "img_v3_xxx" \
--feishu-app-token "$FEISHU_APP_TOKEN"
Sortie : {"media_id": "media_01...", "filename": "photo.jpg"}
Puis passez media_id à la génération :
python3 {baseDir}/scripts/medeo_video.py spawn-task \
--message "Créez une vidéo mettant en scène cette personne" \
--media-ids "media_01..."
Guide d'extraction d'image spécifique à la plateforme
| Plateforme | Comment obtenir la source de l'image | Argument upload-file |
|---|---|---|
| Telegram | message.photo[-1].file_id | --telegram-file-id |
| Discord | message.attachments[0].url (URL CDN publique) | --url |
| Feishu | message_id + image_key du JSON du contenu du message | --feishu-message-id + --feishu-image-key |
Télécharger le binaire de la pièce jointe → sauvegarder dans /tmp | --file | |
| URL générique | Toute URL d'image directe | --url |
Remarque : Les URL des pièces jointes Discord sont des liens CDN publics — --url fonctionne directement. Toutes les autres plateformes nécessitent une authentification pour télécharger.
3c. En ligne dans le pipeline de génération
# Basé sur URL (comportement existant)
python3 {baseDir}/scripts/medeo_video.py spawn-task \
--message "Présentation du produit pour cette basket" \
--media-urls "https://example.com/front.jpg" "https://example.com/side.jpg"
Prend en charge .jpg, .png, .webp, .mp4, .mov, .gif. Une résolution plus élevée + plusieurs angles = meilleurs résultats.
3d. Vérifier le statut du téléchargement
Après upload ou upload-file, si vous devez vérifier la tâche de téléchargement :
python3 {baseDir}/scripts/medeo_video.py upload-status --job-id "job_01..."
Retourne le statut du média (processing, completed, failed) et media_id une fois terminé.
4. Commandes de pipeline bas niveau (agent interne — ne jamais exposer aux utilisateurs)
Ces commandes sont destinées au débogage par l'agent ou à une intervention manuelle uniquement. Les utilisateurs ne devraient jamais voir ces commandes.
Flux du pipeline :
spawn-task (recommandé, asynchrone)
└── generate (bloquant, même pipeline)
├── upload (si --media-urls)
├── compose → compose-status (interrogation)
└── render → render-status (interrogation)
| Commande | Ce qu'elle fait | Arguments clés |
|---|---|---|
generate | Pipeline complet bloquant (upload→compose→render) | Identique à spawn-task sans les indicateurs de livraison |
compose | Créer un projet uniquement (sans rendu) | --message, --media-ids, --recipe-id |
compose-status | Interroger la tâche compose | --task-id "task_01..." |
render | Effectuer le rendu d'un projet existant | --project-id "project_01..." |
render-status | Interroger la tâche de rendu | --job-id "render_01..." |
upload-status | Interroger la tâche de téléchargement | --job-id "job_01..." |
Toutes les commandes prennent en charge --no-wait pour retourner immédiatement sans attendre.
5. Parcourir les recettes
python3 {baseDir}/scripts/medeo_video.py recipes # lister les modèles
python3 {baseDir}/scripts/medeo_video.py recipes --cursor <c> # pagination
Utilisation dans la génération : --recipe-id "recipe_01...". Voir docs/recipes.md.
6. Référence rapide des commandes (pour l'agent, pas pour l'utilisateur)
| Commande | Description | Visible par l'utilisateur ? |
|---|---|---|
recipes | Lister les modèles vidéo | Oui — "quels modèles sont disponibles ?" |
last-job | Statut de la dernière tâche | Oui — "ma dernière vidéo est-elle terminée ?" |
history | Historique des tâches (50 dernières) | Oui — "affiche mon historique vidéo" |
config | Afficher la configuration actuelle | Non |
config-init --api-key "mk_..." | Initialiser la clé API | Uniquement lors de la configuration |
upload --url "URL" | Télécharger depuis une URL publique | Non (agent interne) |
upload-file --file PATH | Télécharger depuis un fichier local | Non (agent interne) |
upload-file --url "URL" | Télécharger URL → upload | Non (agent interne) |
upload-file --telegram-file-id "..." | Télécharger pièce jointe Telegram | Non (agent interne) |
upload-file --feishu-image-key "..." | Télécharger pièce jointe Feishu | Non (agent interne) |
upload-status --job-id "..." | Vérifier le statut de la tâche d'upload | Non (agent interne) |
compose-status --task-id "..." | Vérifier la progression de la tâche compose | Non (agent interne) |
render-status --job-id "..." | Vérifier la progression du rendu | Non (agent interne) |
7. Règles clés
- Toujours asynchrone —
spawn-task+sessions_spawnpour la génération - Un seul appel pour les histoires — scénarios complets dans un seul
--message, ne divisez jamais - Crédits insuffisants — partagez le lien de recharge à partir du message d'erreur
- Téléchargement d'image IM — Ne téléchargez des images que lorsque l'utilisateur demande explicitement la génération vidéo avec cette image. Ne téléchargez PAS automatiquement chaque message image (l'utilisateur peut avoir d'autres compétences installées). Lorsque déclenché : exécutez d'abord
upload-file→ obtenezmedia_id→ passez-le à la génération via--media-ids. Ne demandez jamais une URL à l'utilisateur s'il a déjà envoyé l'image. - Livraison native IM — Après la génération, livrez la vidéo en utilisant la méthode native du canal IM (pas seulement une URL). Chaque canal a un script de livraison dédié :
- Feishu :
python3 {baseDir}/scripts/feishu_send_video.py --video /tmp/result.mp4 --to "oc_xxx_or_ou_xxx" --cover-url "<thumbnail_url>" --duration <ms>(utilisezoc_chat_id pour les discussions de groupe,ou_open_id pour les discussions privées ; les formes préfixéeschat:oc_xxxetuser:ou_xxxsont également acceptées) - Telegram : Téléchargez la vidéo, puis envoyez via
telegram_send_video.py(jeton depuis l'environnement uniquement) :curl -sL -o /tmp/medeo_result.mp4 "<video_url>" TELEGRAM_BOT_TOKEN="$TELEGRAM_BOT_TOKEN" python3 {baseDir}/scripts/telegram_send_video.py \ --video /tmp/medeo_result.mp4 \ --to "<chat_id>" \ --cover-url "<thumbnail_url>" - Discord : Téléchargez la vidéo, puis envoyez via
discord_send_video.py:curl -sL -o /tmp/medeo_result.mp4 "<video_url>" python3 {baseDir}/scripts/discord_send_video.py \ --video /tmp/medeo_result.mp4 \ --to "<channel_id>" \ --cover-url "<thumbnail_url>"
- Feishu :
8. Variables d'environnement
| Variable | Requise par | But |
|---|---|---|
TELEGRAM_BOT_TOKEN | upload-file --telegram-file-id + telegram_send_video.py | Authentification Telegram |
FEISHU_APP_TOKEN | upload-file --feishu-image-key | Authentification Feishu (pour télécharger des images) |