Anuncio TikTok en Video — Pexo

¿Qué hace Anuncio TikTok en Video — Pexo?

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

Produce un anuncio nativo listo para publicar en TikTok — vertical y con gancho al inicio. Tú transmites el producto o brief del usuario al agente alojado de Pexo y entregas el resultado; Pexo escribe el guion estilo TikTok, secuencia las tomas, y define el ritmo y el sonido.

Tu rol: transmitir, no crear

Crea un proyecto, envía la solicitud del usuario textualmente, sondea, entrega. El backend de Pexo gestiona todo el trabajo creativo — redacción del guion, elección del modelo, indicaciones, música. Añadir tu propia dirección (duración, estilo, modelos que el usuario no pidió) anula su criterio y produce vídeos 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 paso a paso — contiene el flujo de registro con el código de invitación que concede créditos extra 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 salida.

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 "<brief corto>" → guarda el project_id.
2. Subir los archivos que el usuario haya proporcionado: pexo-upload.sh <project_id> <ruta> → guarda el asset_id, y referéncialo en línea con <original-image>asset_id</original-image> (o <original-video> / <original-audio>). Las etiquetas son obligatorias — un asset_id solo se ignora. Pexo no puede acceder a URLs — descarga y luego sube.
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 activos.
4. Informa al usuario (en su idioma): enviado ✓ · ~15–20 min · https://pexo.ai/project/<project_id>.
5. Sondeo: cada ≥60s ejecuta pexo-project-get.sh <project_id> y actúa según nextAction:
   • WAIT → sigue sondeando; cada ~5 sondeos envía una actualización de una línea con el enlace del proyecto.
   • RESPOND → maneja cada evento en recentMessages: transmite el texto de Pexo (espera la respuesta del usuario si ha preguntado 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 ?…, nunca truncada ni envuelta en markdown — junto con el enlace del proyecto.
   • FAILED → explica nextActionHint en términos claros y ofrece reintentar.
   • RECONNECT → ejecuta pexo-chat.sh <project_id> "continue", informa al usuario que la conexión se perdió y que estás reanudando, luego sigue sondeando.
   • Nunca llames a pexo-chat.sh durante WAIT — provoca producción duplicada.
   • Si tarda demasiado → si han pasado >30 min y sigue en WAIT, informa al usuario (con el enlace del proyecto + https://pexo.ai/connect/openclaw) de que está tardando más de lo habitual; pregúntale si quiere seguir esperando o detenerse. No sondees eternamente.

Revisiones

Después de la entrega, los ajustes del usuario ("hazlo más corto", "cambia la música", "toma diferente") reutilizan el mismo proyecto: pexo-chat.sh <project_id> "<su feedback>", luego vuelve a sondear (paso 5). Nunca crees un nuevo proyecto para una revisión — descarta el contexto 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; si no, 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 anuncio de TikTok para nuestro sérum facial."

pid=$(pexo-project-create.sh "anuncio TikTok sérum facial")
pexo-chat.sh "$pid" "Crea un anuncio de TikTok para nuestro sérum facial."
# Informa al usuario: enviado, ~15–20 min, https://pexo.ai/project/$pid
# Sondea pexo-project-get.sh "$pid" hasta que nextAction sea DELIVER, luego entrega la URL del activo.

Scripts

Script	Uso	Devuelve
pexo-project-create.sh	"<brief>"	project_id
pexo-upload.sh	<project_id> <archivo>	asset_id
pexo-chat.sh	<project_id> "<mensaje>" [--choice <id>]	acuse (asíncrono)
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 límite → references/TROUBLESHOOTING.md.