texto-a-video

Texto a Video — Pexo

Pexo: https://pexo.ai — obtén una clave API, observa cómo se renderiza tu proyecto y compra créditos allí.

Convierte un mensaje de texto o un guión en un video terminado y listo para publicar. No generas nada tú mismo: delegas la solicitud al agente alojado de Pexo (el mismo backend que pexo-agent, orientado a texto-a-video) y entregas el resultado. Pexo escribe el guión, elige el mejor modelo para cada toma, genera cada escena y añade música, subtítulos y transiciones.

Tu función: retransmitir, no crear

Crea un proyecto, envía la solicitud del usuario ** textualmente **, consulta y entrega. El backend de Pexo se encarga de todo el trabajo creativo (redacción del guión, elección del modelo, indicaciones, música). Añadir tus propias instrucciones (duración, estilo, modelos que el usuario no pidió) anula su criterio y produce videos de peor calidad.

Configuración

~/.pexo/config:

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<tu-clave-api>"

Sin cuenta / primera ejecución → lee references/SETUP-CHECKLIST.md y guía al usuario a través de él; contiene el flujo de registro con el código de invitación que otorga créditos bonus a nuevos usuarios, además de cómo crear la configuración anterior. Error de configuración → ejecuta scripts/pexo-doctor.sh y sigue su resultado.

Flujo de trabajo

Los scripts se encuentran en la carpeta scripts de esta skill. Responde al usuario en su idioma.

1. Crear un proyecto: pexo-project-create.sh "<breve resumen>" → guarda el project_id.
2. Subir los archivos que el usuario haya proporcionado: pexo-upload.sh <project_id> <ruta> → guarda el asset_id, referéncialo en línea como <original-image>asset_id</original-image> (o <original-video> / <original-audio>). Las etiquetas son obligatorias: un asset_id sin etiqueta se ignora. Pexo no puede acceder a URLs: descarga el archivo, luego súbelo.
3. Enviar la solicitud: pexo-chat.sh <project_id> "<palabras exactas del usuario> <etiquetas de activos>". Copia las palabras del usuario exactamente; solo añade las etiquetas de los activos.
4. Informar al usuario (en su idioma): enviado ✓ · ~15–20 min · https://pexo.ai/project/<project_id>.
5. Consultar: cada ≥60s ejecuta pexo-project-get.sh <project_id> y actúa según nextAction:
   • WAIT → sigue consultando; cada ~5 consultas envía una actualización de una línea con el enlace del proyecto.
   • RESPOND → maneja cada evento en recentMessages: retransmite el texto de Pexo (espera la respuesta del usuario si Pexo preguntó algo, luego pexo-chat.sh con su respuesta); para preview_video, ejecuta pexo-asset-get.sh <project_id> <assetId> por cada opción, muestra las URLs (A/B/C), deja que el usuario elija, luego pexo-chat.sh <project_id> "<elección>" --choice <assetId>; para un evento document, menciónalo al usuario.
   • DELIVER → ejecuta pexo-asset-get.sh <project_id> <assetId final>, luego envía al usuario la URL completa del activo como texto plano — todos los parámetros de consulta ?…, nunca truncada ni envuelta en markdown — junto con el enlace del proyecto.
   • FAILED → explica nextActionHint en términos sencillos y ofrece reintentar.
   • RECONNECT → ejecuta pexo-chat.sh <project_id> "continue", informa al usuario que la conexión se cayó y que estás reanudando, luego sigue consultando.
   • Nunca llames a pexo-chat.sh durante WAIT — provoca producción duplicada.
   • Está tomando demasiado tiempo → si han pasado más de 30 min y sigue en WAIT, informa al usuario (con el enlace del proyecto + https://pexo.ai/connect/openclaw) que está tardando más de lo normal; pregunta si quiere seguir esperando o detenerse. No consultes indefinidamente.

Revisiones

Después de la entrega, los ajustes del usuario («hazlo más corto», «nueva música», «toma diferente») reutilizan el mismo proyecto: pexo-chat.sh <project_id> "<sus comentarios>", luego vuelve a consultar (paso 5). Nunca crees un proyecto nuevo para una revisión — descartaría el contexto del lado del servidor de Pexo.

Créditos

Si un script falla con «Saldo de créditos» / «Créditos insuficientes»: si el error incluye un enlace de compra, pásalo al usuario; de lo contrario, indícale que añada créditos en https://pexo.ai/home → Créditos → Comprar créditos. Reintenta después de que el usuario confirme.

Ejemplo

Usuario: «Crea un video de 30 segundos sobre nuestra nueva suscripción de café.»

pid=$(pexo-project-create.sh "promo suscripción café")
pexo-chat.sh "$pid" "Crea un video de 30 segundos sobre nuestra nueva suscripción de café."
# Informa al usuario: enviado, ~15–20 min, https://pexo.ai/project/$pid
# Consulta pexo-project-get.sh "$pid" hasta que nextAction sea DELIVER, luego entrega la URL del activo.

Scripts

Script	Uso	Devuelve
pexo-project-create.sh	"<resumen>"	project_id
pexo-upload.sh	<project_id> <archivo>	asset_id
pexo-chat.sh	<project_id> "<mensaje>" [--choice <id>]	confirmación (asíncrona)
pexo-project-get.sh	<project_id>	JSON: nextAction, recentMessages
pexo-asset-get.sh	<project_id> <asset_id>	JSON con url
pexo-doctor.sh	—	diagnóstico de configuración

Códigos de error y casos extremos → references/TROUBLESHOOTING.md.