product-video

Product Video — Pexo

Pexo: https://pexo.ai — obtenez une clé API, regardez votre projet s'afficher et achetez des crédits là-bas.

Transformez les photos d'un produit en une vidéo soignée et prête à être publiée. Vous téléchargez les images du produit de l'utilisateur et transmettez la requête à l'agent Pexo hébergé, puis vous délivrez le résultat — Pexo compose les plans, le mouvement et la musique.

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

Créez un projet, envoyez la requête 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) annule son jugement et produit des vidéos de moins bonne qualité.

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 celle-ci — elle contient le flux d'inscription avec le code d'invitation qui accorde des crédits bonus aux nouveaux utilisateurs, ainsi que la manière 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 la 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 parcourir les URLs — téléchargez, puis uploadez.
3. Envoyez la requête : pexo-chat.sh <project_id> "<mots exacts de l'utilisateur> <balises des assets>". Copiez les mots de l'utilisateur exactement ; ajoutez uniquement les balises des assets.
4. Dites à 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 sur 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 URLs (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 de l'asset complète en texte brut — tous les paramètres de requête ?…, jamais tronquée ou enveloppée dans du 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é interrompue et que vous reprenez, puis continuez d'interroger.
   • N'appelez jamais pexo-chat.sh pendant WAIT — cela déclenche une production en double.
   • Trop long → si cela fait >30 min et toujours WAIT, dites à l'utilisateur (avec le lien du projet + https://pexo.ai/connect/openclaw) que le traitement est long ; demandez s'il veut continuer à attendre ou arrêter. N'interrogez pas indéfiniment.

Révisions

Après livraison, les modifications de l'utilisateur ("raccourcis", "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 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 : "Fais une vidéo produit de 20 secondes à partir de ces trois photos de baskets."

pid=$(pexo-project-create.sh "vidéo produit de baskets")
pexo-chat.sh "$pid" "Fais une vidéo produit de 20 secondes à partir de ces trois photos de baskets."
# 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'asset.

Scripts

Script	Utilisation	Renvoie
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 (async)
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.