explainer-video

Explainer Video — Pexo

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

Produisez une vidéo explicative claire et narrée. Vous relayez le sujet de l'utilisateur à l'agent Pexo hébergé et vous livrez le résultat ; Pexo écrit le script, génère les visuels plan par plan, et ajoute la voix off et les sous-titres.

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

Créez un projet, envoyez la demande de l'utilisateur textuellement, sondez, livrez. Le backend de Pexo gère tout le travail créatif — écriture du script, choix du modèle, prompts, musique. Ajouter vos propres consignes (durée, style, modèles que l'utilisateur n'a pas demandés) remplace 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 création du fichier de configuration ci-dessus. Erreur de configuration → exécutez scripts/pexo-doctor.sh et suivez sa sortie.

Workflow

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 "<bref descriptif>" → enregistrez le project_id.
2. Téléversez les éventuels fichiers fournis par l'utilisateur : pexo-upload.sh <project_id> <chemin> → enregistrez l'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 explorer d'URL — téléchargez d'abord, puis téléversez.
3. Envoyez la requête : pexo-chat.sh <project_id> "<mots exacts de l'utilisateur> <balises d'actifs>". Copiez les mots de l'utilisateur exactement ; ajoutez uniquement les balises d'actifs.
4. Informez l'utilisateur (dans sa langue) : soumise ✓ · ~15 à 20 min · https://pexo.ai/project/<project_id>.
5. Sondez : toutes les ≥60 secondes exécutez pexo-project-get.sh <project_id> et agissez selon nextAction :
   • WAIT → continuez de sonder ; toutes les ~5 tentatives, 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 s'il a posé une question, puis pexo-chat.sh leur 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'intégralité de l'URL de l'actif sous forme de texte brut — tous les paramètres de requête ?…, jamais tronquée ni encapsulée dans du markdown — plus 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 de sonder.
   • N'appelez jamais pexo-chat.sh pendant WAIT — cela déclenche une production en double.
   • Trop long → si cela fait plus de 30 min et toujours WAIT, dites à l'utilisateur (avec le lien du projet
     • https://pexo.ai/connect/openclaw) que c'est long ; demandez s'il veut continuer à attendre ou arrêter. Ne sondez pas indéfiniment.

Révisions

Après livraison, les ajustements de l'utilisateur ("raccourcis", "nouvelle musique", "plan différent") réutilisent le même projet : pexo-chat.sh <project_id> "<son retour>", puis sondez à 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, passez-le à l'utilisateur ; sinon dites-lui d'ajouter des crédits sur https://pexo.ai/home → Crédits → Acheter des crédits. Relancez après confirmation.

Exemple

Utilisateur : "Explique le fonctionnement de notre application de budgétisation dans une vidéo de 60 secondes."

pid=$(pexo-project-create.sh "explication application budgétisation")
pexo-chat.sh "$pid" "Explique le fonctionnement de notre application de budgétisation dans une vidéo de 60 secondes."
# Dites à l'utilisateur : soumise, ~15–20 min, https://pexo.ai/project/$pid
# Sondez pexo-project-get.sh "$pid" jusqu'à ce que nextAction soit DELIVER, puis livrez l'URL de l'actif.

Scripts

Script	Utilisation	Retourne
pexo-project-create.sh	"<descriptif>"	project_id
pexo-upload.sh	<project_id> <fichier>	asset_id
pexo-chat.sh	<project_id> "<message>" [--choice <id>]	ack (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 d'installation

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