Texto para Vídeo — Pexo

O que Texto para Vídeo — Pexo faz?

Pexo: https://pexo.ai — obtenha uma chave de API, acompanhe a renderização do seu projeto e compre créditos lá.

Transforme um prompt ou roteiro escrito em um vídeo completo e pronto para publicação. Você não gera nada por conta própria: você passa a solicitação para o agente hospedado Pexo (mesmo backend do pexo-agent, com escopo para texto-para-vídeo) e entrega o resultado. O Pexo escreve o roteiro, escolhe o melhor modelo para cada cena, gera cada cena, e adiciona música, legendas e transições.

Seu papel: retransmitir, não criar

Crie um projeto, envie a solicitação do usuário textualmente, faça polling, entregue. O backend do Pexo lida com todo o trabalho criativo — redação de roteiro, escolha do modelo, prompts, música. Adicionar suas próprias diretrizes (duração, estilo, modelos que o usuário não pediu) substitui o julgamento do sistema e produz vídeos piores.

Configuração

~/.pexo/config:

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<sua-chave-api>"

Sem conta / primeira execução → leia references/SETUP-CHECKLIST.md e guie o usuário pelo processo — ele contém o fluxo de cadastro com o código de convite que concede créditos bônus a novos usuários, além de como criar a configuração acima. Erro de configuração → execute scripts/pexo-doctor.sh e siga sua saída.

Fluxo de trabalho

Os scripts estão na pasta scripts/ desta skill. Responda ao usuário no idioma dele.

1. Crie um projeto: pexo-project-create.sh "<breve descrição>" → salve o project_id.
2. Faça upload de quaisquer arquivos que o usuário forneceu: pexo-upload.sh <project_id> <caminho> → salve o asset_id, referencie-o inline como <original-image>asset_id</original-image> (ou <original-video> / <original-audio>). As tags são obrigatórias — um asset_id sem tag é ignorado. O Pexo não consegue acessar URLs — baixe o arquivo primeiro, depois faça upload.
3. Envie a solicitação: pexo-chat.sh <project_id> "<palavras exatas do usuário> <tags dos assets>". Copie as palavras do usuário exatamente; adicione apenas as tags dos assets.
4. Informe o usuário (no idioma dele): submetido ✓ · ~15–20 min · https://pexo.ai/project/<project_id>.
5. Faça polling: a cada ≥60s execute pexo-project-get.sh <project_id> e aja de acordo com nextAction:
   • WAIT → continue fazendo polling; a cada ~5 polls, envie uma atualização de uma linha com o link do projeto.
   • RESPOND → trate cada evento em recentMessages: retransmita o texto do Pexo (aguarde a resposta do usuário se ele perguntou algo, depois pexo-chat.sh com a resposta); para preview_video, execute pexo-asset-get.sh <project_id> <assetId> por opção, mostre as URLs (A/B/C), deixe o usuário escolher, depois pexo-chat.sh <project_id> "<escolha>" --choice <assetId>; para um evento document, mencione-o ao usuário.
   • DELIVER → execute pexo-asset-get.sh <project_id> <assetId final>, depois envie ao usuário a URL completa do asset como texto simples — todos os parâmetros de consulta ?…, nunca truncada ou envolvida em markdown — junto com o link do projeto.
   • FAILED → explique o nextActionHint em termos simples e ofereça-se para tentar novamente.
   • RECONNECT → execute pexo-chat.sh <project_id> "continue", informe ao usuário que a conexão caiu e que você está retomando, depois continue fazendo polling.
   • Nunca chame pexo-chat.sh durante WAIT — isso dispara produção duplicada.
   • Está demorando muito → se já passou de 30 min e ainda está WAIT, informe o usuário (com o link do projeto + https://pexo.ai/connect/openclaw) que está demorando; pergunte se ele quer continuar esperando ou parar. Não faça polling para sempre.

Revisões

Após a entrega, ajustes do usuário ("deixar mais curto", "nova música", "cena diferente") reutilizam o mesmo projeto: pexo-chat.sh <project_id> "<feedback deles>", depois faça polling novamente (passo 5). Nunca crie um novo projeto para uma revisão — isso descarta o contexto do servidor do Pexo.

Créditos

Se um script falhar com "Saldo de créditos" / "Créditos insuficientes": se o erro trouxer um link de compra, repasse-o ao usuário; caso contrário, informe-o para adicionar créditos em https://pexo.ai/home → Créditos → Comprar Créditos. Tente novamente após a confirmação.

Exemplo

Usuário: "Crie um vídeo de 30 segundos sobre nossa nova assinatura de café."

pid=$(pexo-project-create.sh "promo assinatura de café")
pexo-chat.sh "$pid" "Crie um vídeo de 30 segundos sobre nossa nova assinatura de café."
# Informe o usuário: submetido, ~15–20 min, https://pexo.ai/project/$pid
# Faça polling de pexo-project-get.sh "$pid" até nextAction ser DELIVER, depois entregue a URL do asset.

Scripts

Script	Uso	Retorna
pexo-project-create.sh	"<descrição>"	project_id
pexo-upload.sh	<project_id> <arquivo>	asset_id
pexo-chat.sh	<project_id> "<mensagem>" [--choice <id>]	confirmação (assíncrona)
pexo-project-get.sh	<project_id>	JSON: nextAction, recentMessages
pexo-asset-get.sh	<project_id> <asset_id>	JSON com url
pexo-doctor.sh	—	diagnóstico de configuração

Códigos de erro e casos extremos → references/TROUBLESHOOTING.md.