Communitygithub.com

image-to-video

Transforme une image fixe en vidéo animée grâce à l'agent Pexo, avec gestion du projet, téléchargement, suivi et livraison.

Qu'est-ce que image-to-video ?

Cette compétence permet de transformer une image fixe en une vidéo complète animée via l'agent hébergé Pexo. L'utilisateur télécharge une image, la compétence relaie la requête vers Pexo qui gère automatiquement l'ajout de mouvement, de caméra, de musique et l'assemblage final. Elle ne nécessite aucune création artistique de la part de l'utilisateur. La compétence gère l'ensemble du flux : création de projet, téléchargement de fichiers, envoi de la requête, interrogation périodique (polling), gestion des révisions et rachat de crédits. Elle prend en charge les événements WAIT, RESPOND, DELIVER, FAILED et RECONNECT, et s'intègre avec les scripts shell locaux (`pexo-project-create.sh`, `pexo-upload.sh`, `pexo-chat.sh`, `pexo-project-get.sh`, `pexo-asset-get.sh`, `pexo-doctor.sh`). Elle est conçue pour fonctionner avec l'API Pexo (pexo.ai) et est adaptée aux agents de codage comme Claude Code, Cursor, ou Codex.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pexoai/pexo-skills/tree/main/skills/image-to-video

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Image to Video — Pexo

Pexo : https://pexo.ai — obtenez une clé API, regardez votre projet se rendre et achetez des crédits ici.

Donnez vie à une image fixe sous forme de vidéo terminée. Vous téléchargez l'image de l'utilisateur, transmettez la demande à l'agent Pexo hébergé et livrez le résultat — Pexo ajoute le mouvement, le déplacement de caméra, la musique et assemble le clip final.

Votre rôle : relayer, ne pas créer

Créez un projet, envoyez la demande de l'utilisateur textuellement, interrogez, livrez. Le backend de Pexo gère tout le travail créatif — écriture du script, choix du modèle, prompts, musique. Ajouter vos propres directives (durée, style, modèles que l'utilisateur n'a pas demandés) remplace son jugement et produit de moins bonnes vidéos.

Configuration

~/.pexo/config :

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<votre-clé-api>"

Pas de compte / première exécution → lisez references/SETUP-CHECKLIST.md et guidez l'utilisateur à travers — ce fichier contient le flux d'inscription avec le code d'invitation qui accorde aux nouveaux utilisateurs des crédits bonus, ainsi que la façon de créer la configuration ci-dessus. Erreur de configuration → exécutez scripts/pexo-doctor.sh et suivez sa sortie.

Flux de travail

Les scripts se trouvent dans le dossier scripts/ de cette compétence. Répondez à l'utilisateur dans sa langue.

  1. Créez un projet : pexo-project-create.sh "<brève description>" → enregistrez le project_id.
  2. Téléchargez les fichiers donnés par l'utilisateur : pexo-upload.sh <project_id> <chemin> → enregistrez asset_id, référencez-le en ligne sous forme <original-image>asset_id</original-image> (ou <original-video> / <original-audio>). Les balises sont obligatoires — un asset_id nu est ignoré. Pexo ne peut pas explorer les URL — téléchargez puis téléversez.
  3. Envoyez la demande : pexo-chat.sh <project_id> "<mots exacts de l'utilisateur> <balises des fichiers>". Copiez les mots de l'utilisateur exactement ; ajoutez uniquement les balises des fichiers.
  4. Informez l'utilisateur (dans sa langue) : soumis ✓ · ~15–20 min · https://pexo.ai/project/<project_id>.
  5. Interrogez : toutes les ≥60s exécutez pexo-project-get.sh <project_id> et agissez selon nextAction :
    • WAIT → continuez d'interroger ; toutes les ~5 interrogations envoyez une mise à jour d'une ligne avec le lien du projet.
    • RESPOND → gérez chaque événement dans recentMessages : relayez le texte de Pexo (attendez la réponse de l'utilisateur si Pexo a posé une question, puis pexo-chat.sh sa réponse) ; pour preview_video, exécutez pexo-asset-get.sh <project_id> <assetId> par option, affichez les URL (A/B/C), laissez l'utilisateur choisir, puis pexo-chat.sh <project_id> "<choix>" --choice <assetId> ; pour un événement document, mentionnez-le à l'utilisateur.
    • DELIVER → pexo-asset-get.sh <project_id> <assetId final>, puis envoyez à l'utilisateur l'URL complète de l'actif sous forme de texte brut — tous les paramètres de requête ?…, jamais tronquée ou encapsulée en markdown — ainsi que le lien du projet.
    • FAILED → expliquez nextActionHint en termes simples et proposez de réessayer.
    • RECONNECT → pexo-chat.sh <project_id> "continue", dites à l'utilisateur que la connexion a été perdue et que vous reprenez, puis continuez d'interroger.
    • N'appelez jamais pexo-chat.sh pendant WAIT — cela déclenche une production en double.
    • Prend trop de temps → si cela fait plus de 30 min et toujours WAIT, dites à l'utilisateur (avec le lien du projet + https://pexo.ai/connect/openclaw) que l'exécution est longue ; demandez s'il souhaite continuer à attendre ou arrêter. N'interrogez pas indéfiniment.

Révisions

Après livraison, les ajustements de l'utilisateur (« rends-le plus court », « nouvelle musique », « plan différent ») réutilisent le même projet : pexo-chat.sh <project_id> "<son retour>", puis interrogez à nouveau (étape 5). Ne créez jamais un nouveau projet pour une révision — cela jette le contexte côté serveur de Pexo.

Crédits

Si un script échoue avec « Solde de crédits » / « Crédits insuffisants » : si l'erreur contient un lien d'achat, transmettez-le à l'utilisateur ; sinon dites-lui d'ajouter des crédits sur https://pexo.ai/home → Crédits → Acheter des crédits. Réessayez après confirmation.

Exemple

Utilisateur : « Anime cette photo de produit en un clip de 10 secondes avec un zoom lent. »

pid=$(pexo-project-create.sh "animer photo produit")
pexo-chat.sh "$pid" "Anime cette photo de produit en un clip de 10 secondes avec un zoom lent."
# Dites à l'utilisateur : soumis, ~15–20 min, https://pexo.ai/project/$pid
# Interrogez pexo-project-get.sh "$pid" jusqu'à ce que nextAction soit DELIVER, puis livrez l'URL de l'actif.

Scripts

ScriptUtilisationRetourne
pexo-project-create.sh"<brève description>"project_id
pexo-upload.sh<project_id> <fichier>asset_id
pexo-chat.sh<project_id> "<message>" [--choice <id>]accusé de réception (asynchrone)
pexo-project-get.sh<project_id>JSON : nextAction, recentMessages
pexo-asset-get.sh<project_id> <asset_id>JSON avec url
pexo-doctor.sh—diagnostic de configuration

Codes d'erreur et cas limites → references/TROUBLESHOOTING.md.

Individual skills in this repo

This repo contains 19 individual skills — each has its own dedicated page.

Skills associés