Geração de vídeos de construção em miniatura e diorama
Noite alta: um konbini japonês do tamanho de uma caixa de fósforos brilha em âmbar; a câmera se move lentamente da escuridão em sua direção—o bokeh engole o mundo enquanto a porta de vidro, as prateleiras e as pequenas lâmpadas fluorescentes permanecem nítidas. Essa imersão "pequeno mas real" é o gancho emocional que esta skill visa.
Conbini, barraca de macarrão sob a chuva, oficina cyberpunk—ou uma foto de uma construção finalizada: uma linha ou uma imagem → clipe.
Dependências: WERYAI_API_KEY + Node.js 18+. Quando você executar a CLI, scripts/video_gen.js deve existir; WERYAI_VIDEO_API.md deve existir em resources/ (forneça ambos via publicação ou montagem pré-uso). Comandos completos e campos JSON: consulte resources/WERYAI_VIDEO_API.md. Nenhuma outra skill do Cursor. Parâmetros padrão e níveis de modelo estão nas tabelas abaixo; os limites da API ao vivo seguem os modelos weryai. Antes de instalar ou executar, revise o video_gen.js incluído para confirmar que atende aos seus requisitos. Preste atenção especial em como ele lida com arquivos locais, se você optar por permitir seu uso, garantindo que esse comportamento esteja alinhado com o fluxo de trabalho pretendido para solicitações de imagem para vídeo.
Metadados do registro: O único segredo de tempo de execução necessário é WERYAI_API_KEY. Ele aparece no frontmatter YAML como requires.env de nível superior (mapeamento de fluxo, para ferramentas que achatam apenas chaves raiz), metadata.openclaw.primaryEnv e metadata.openclaw.requires.env. Diretórios de skills e registros devem mostrar esse requisito desde o início para que os instaladores o vejam antes do download. Nunca confirme a chave dentro do pacote.
Antes de instalar ou definir WERYAI_API_KEY
- Confiança: Confirme que você confia na WeryAI e aceita que prompts e entradas de imagem (URLs e, se usado, bytes enviados) são enviados para os servidores da WeryAI pela rede.
- Conteúdo sensível: Não coloque segredos em
prompt. Não forneça URLs de imagem ou arquivos locais que você considere sensíveis, a menos que aceite o processamento pelo provedor. --dry-runprimeiro: Executenode scripts/video_gen.js wait --json '…' --dry-run(e/ousubmit-*com--dry-run) antes de definir uma chave para inspecionar a estrutura JSON;WERYAI_API_KEYnão é necessária para--dry-runapenas (consulteWERYAI_VIDEO_API.md).- Fonte: Se você não puder verificar o autor do pacote ou precisar de controle estrito de dados, não defina
WERYAI_API_KEY, ou execute apenas em um ambiente isolado / de teste.
Variáveis de ambiente (video_gen.js incluído)
- Necessário para chamadas reais de API: Apenas
WERYAI_API_KEY(modelos, geração, status, upload de imagem local). Não necessário para apenas--dry-run. - Não lido por este script: As variáveis de ambiente não substituem os nomes de host da API;
https://api.weryai.comehttps://api-growth-agent.weryai.comsão fixos no código (consulte Segurança). Não espere parâmetros de substituição de URL—não há nenhum nesta versão. - Polling:
waitusa backoff exponencial fixo e constantes de tempo limite no script (consulteWERYAI_VIDEO_API.md), não variáveis de ambiente de poll separadas neste pacote.
Padrões do script vs. skill (devem corresponder ao JSON)
model: A CLI não tem modelo padrão embutido. Semodelestiver ausente ou vazio no JSON,video_gen.jsretornaMISSING_PARAM(no default model). O padrão recomendado desta skill nas tabelas éKLING_V3_0_PRO—sempre passe"model":"<chave confirmada>"explicitamente no JSON dewait/submit-*para que corresponda à tabela de pré-envio.resolution: ParaKLING_V3_0_PRO(nível padrão desta skill), omitaresolutioncompletamente do JSON—enviá-lo pode causar erros1002/ de parâmetro para modelos que não suportam esse campo. Adicioneresolutionapenas quando o modelo escolhido o listar emnode scripts/video_gen.js modelse sua tabela de confirmação o incluir explicitamente.
Pré-requisitos
WERYAI_API_KEYdeve estar definida no ambiente antes de executarvideo_gen.js.- Node.js 18+ é necessário. Prefira URLs de imagem
httpspúblicas. Se oscripts/video_gen.jsmontado suportar caminhos de arquivo locais, revise e verifique o script primeiro, depois obtenha consentimento explícito antes que ele leia uma imagem local e a envie para a WeryAI para obter uma URL pública. - Cada execução bem-sucedida de
waitconsome créditos WeryAI; reexecutar cria novas tarefas pagas.
Segurança, segredos e hosts da API
WERYAI_API_KEY: Trate como um segredo. Configure-o apenas se você confiar na fonte desta skill; ele está listado nos metadados do OpenClaw comorequires.env/primaryEnvpara que os instaladores saibam que é obrigatório em tempo de execução (nunca o confirme dentro do pacote da skill).- Hosts da API (fixos em
video_gen.js): As tarefas de vídeo usamhttps://api.weryai.com; a lista de modelos usahttps://api-growth-agent.weryai.com. O script incluído fixa essas bases no código—apenasWERYAI_API_KEYé lida do ambiente para autenticação. Não confie em nenhuma variável de ambiente para alterar os nomes de host da API; as solicitações vão apenas para esses endpoints oficiais mais a URL de upload documentada quando uma imagem local é enviada (consulteWERYAI_VIDEO_API.md). - Divulgação de manipulação de imagem local: Prefira URLs de imagem
httpspúblicas. Se oscripts/video_gen.jsmontado suportar caminhos de arquivo locais, ele pode ler uma imagem local e enviá-la para a WeryAI para obter uma URL pública; exija revisão/verificação e consentimento explícito antes de usar esse caminho. - Processamento remoto: Execuções pagas enviam
prompte entradas de imagem para a WeryAI; consulte## Antes de instalar ou definirWERYAI_API_KEY``. - Maior segurança: Siga
## Antes de instalar ou definirWERYAI_API_KEY``; use um ambiente de curta duração ou isolado para execuções pagas; revisescripts/video_gen.js(loop de submit HTTPS + poll) antes do uso em produção. Verifique se o tempo de execução pode ler arquivos de imagem locais e enviá-los para a WeryAI, e obtenha consentimento explícito antes de usar esse caminho.
Expansão de prompt (obrigatória)
video_gen.js não expande prompts. Antes de cada wait --json, transforme o resumo curto ou vago do usuário em um prompt de produção completo em inglês.
Quando: O usuário fornece apenas palavras-chave, uma linha ou intenção vaga—ou pede uma linguagem de vídeo mais rica. Exceção: Eles colam um prompt longo finalizado dentro do prompt_length_limit do modelo e pedem que você não o reescreva; ainda assim mostre o texto completo na tabela de confirmação.
Sempre adicione (linguagem de vídeo): escala e ângulo do plano; movimento da câmera ou travamento; qualidade e motivação da luz; ação do sujeito ajustada à duration; um payoff claro para este nicho; indique 9:16 vertical quando esta skill usar vertical como padrão.
Comprimento: Obedeça a prompt_length_limit para o model_key escolhido quando este documento o listar; remova adjetivos de preenchimento antes de remover cláusulas de ação, lente ou luz principais.
Confirmação: A tabela de pré-envio deve incluir o prompt expandido completo (nunca um resumo de uma linha). Aguarde confirmação ou edições.
Lista de verificação de nicho
- Mundo miniatura: profundidade de campo rasa, luzes práticas e aconchegantes, revelação dolly/push-in; diorama ou sala em uma caixa.
- Batidas: construir → pintar → luzes acesas ou passagem de veículo; atmosfera aconchegante, materiais táteis.
- Referências de escala: palitos de fósforo, moedas ou pontas de dedo, onde útil.
### Exemplos de prompts no topo deste arquivo são apenas gatilhos curtos—sempre expanda a partir da solicitação real do usuário.
Fluxo de trabalho
- Confirme se a solicitação do usuário corresponde ao cenário desta skill (texto para vídeo e/ou imagem para vídeo, conforme documentado).
- Colete o resumo do usuário, URL(s) de imagem opcional(is), nível (melhor / bom / rápido) ou uma chave
modelexplícita. - Expanda o prompt (obrigatório): A menos que o usuário tenha fornecido um prompt longo finalizado e explicitamente pedido para não reescrevê-lo, expanda o resumo em um
promptde produção completo em inglês usando## Expansão de prompt (obrigatória)abaixo. Não chame a API apenas com as palavras mínimas do usuário. - Verifique o
promptexpandido em relação aoprompt_length_limitdo modelo selecionado nas tabelas congeladas neste documento (quando presente); encurte se necessário. - Verifique
duration,aspect_ratio,generate_audio,negative_prompte outros campos em relação às tabelas congeladas neste documento eWERYAI_VIDEO_API.md. Incluaresolutionapenas quando omodelselecionado o suportar (para o nível KLING padrão desta skill, não envieresolution—consulte## Padrões do script vs. skill). - Mostre a tabela de parâmetros de pré-envio incluindo o
promptexpandido completo; aguarde confirmação ou edições. - Após a confirmação, execute
node scripts/video_gen.js wait --json '...'com o prompt expandido. - Analise o JSON de saída padrão e retorne as URLs do vídeo; em caso de falha, exiba
errorCode/errorMessagee sugira correções de parâmetros.
Referência da CLI
node scripts/video_gen.js wait --json '{"model":"…","prompt":"…","duration":5,"aspect_ratio":"9:16"}'
node scripts/video_gen.js wait --json '…' --dry-run
node scripts/video_gen.js status --task-id <id>
Referência completa: WERYAI_VIDEO_API.md.
Definição de concluído
Concluído quando o usuário recebe pelo menos uma URL de vídeo reproduzível da resposta da API, ou uma explicação clara de falha com próximos passos. Todos os parâmetros usados devem estar dentro dos conjuntos permitidos do modelo selecionado neste documento. O prompt enviado deve ser o prompt de produção expandido, a menos que o usuário tenha explicitamente fornecido um prompt longo finalizado e pedido para não reescrevê-lo.
Limites (fora do escopo)
- Não revisa conformidade da plataforma, direitos autorais ou direitos de imagem; não garante a usabilidade comercial das saídas.
- Não fornece renderização offline não WeryAI, linhas do tempo de edição tradicionais ou combinações de campos de API não documentadas neste SKILL ou
WERYAI_VIDEO_API.md. - Não vincule a
weryai-model-capabilities.mdou caminhos../references/compartilhados; useresources/WERYAI_VIDEO_API.mdpara detalhes da CLI/API. - Não codifique caminhos absolutos no documento da skill; execute
node scripts/...a partir da raiz do pacote da skill (o diretório que contémSKILL.md) para que os caminhosscripts/eresources/sejam resolvidos.
Exemplos de prompts
Mini café construído à mão: última batida com luzes acesas dentro, preenchimento quente, push-in vertical lentoUse este still de diorama de rua: miniatura de carro passa, vitrines acendemModelo pintado em base, revelação giratória, profundidade de campo ultra-rasaRevelação de construção miniatura 9:16, luzes aconchegantes quentes acendendo dentro de minicasa
Parâmetros padrão
| Campo | Valor |
|---|---|
| Modelo | KLING_V3_0_PRO (deve aparecer como "model" no JSON—o script não o define como padrão) |
| Proporção | 9:16 (vertical fixa) |
| Duração | Curta (duration: 5); use 10 para uma passagem de construção mais longa |
| Resolução | Omita para o padrão KLING (não inclua a chave no JSON) |
| Estilo | Profundidade de campo muito rasa, materiais verossímeis, luz de destaque em objetos principais, push-in lento ou órbita sutil (fixo) |
| Áudio | Ligado (tom ambiente + detalhe de objeto miniatura para imersão) |
Validade da API (padrão
KLING_V3_0_PRO): Texto para vídeodurationapenas 5 / 10 / 15;aspect_ratioapenas 9:16, 1:1, 16:9. Imagem para vídeoaspect_ratioapenas 9:16, 16:9, 1:1. Sem camporesolution—não o envie. Para o nível rápido com VEO: texto para vídeoVEO_3_1_FAST, imagem para vídeoCHATBOT_VEO_3_1_FAST, comdurationfixa em 8,aspect_ratioapenas 9:16 ou 16:9. Ao alterarmodel_key, siga os conjuntos permitidos nas restrições de modelo/API desta seção e na nota de validade da API acima; não envieresolutionpara modelos que não a suportam.
Descrição de cena → mundo miniatura
Propósito: Ideias concretas de cena, testes visuais rápidos ou variações de clima em lote—nenhum modelo físico necessário.
Entradas:
Tipo de cena (konbini / cozinha / casa de campo / barraca de esquina / oficina / conjunto cyber) e clima (acolhedor / neon cyber / diurno / âmbar chuvoso). Se o clima for omitido, escolha a iluminação que geralmente funciona para aquela cena. Opcionalmente, enfatize processo de construção vs. tour finalizado.
Extraia objetos principais e luz, escolha um ângulo que provoque "quero isso", construa o prompt, mostre os parâmetros completos, aguarde confirmação, depois node scripts/video_gen.js wait --json '…'.
Os parâmetros completos são mostrados antes da geração; aguarde confirmação.
Configuração de parâmetros:
| Campo | Valor |
|---|---|
| model | KLING_V3_0_PRO |
| aspect_ratio | 9:16 |
| duration | 5 |
| generate_audio | true |
| resolution | (omitir—não enviar para este modelo) |
Exemplos de entrada:
"Konbini japonês à noite, acolhedor" → a skill constrói:
Close-up extremo macro no nível dos olhos, um diorama de loja de conveniência japonesa do tamanho de uma palma sobre uma superfície escura, luz interior âmbar quente brilha através de pequenas portas de vidro deslizantes e janelas de vitral iluminando um interior perfeitamente detalhado — prateleiras em miniatura abarrotadas de pacotes de produtos do tamanho de polegares, um minúsculo balcão de caixa, um painel de teto softbox. A câmera faz um dolly-in muito lento a 30fps em direção à entrada como se estivesse andando até ela, a profundidade de campo rasa mantém apenas a fachada da loja nitidamente focada enquanto a escuridão ao redor se dissolve. Luz ambiente externa azul fria da noite preenche o exterior, criando uma divisão de cores quente-fria no limiar da porta. Zumbido ambiente ASMR suave, som distante de cidade à noite, música ambiente fraca.
"Oficina cyberpunk, neon" →
Close-up médio em ângulo de 45 graus acima, um diorama de estúdio cyberpunk em miniatura do tamanho de uma caixa de sapatos — abarrotado de pequenos monitores brilhantes, escrivaninha coberta de cabos, estantes iluminadas por neon em rosa e ciano, uma miniatura de action figure no teclado. A câmera orbita lentamente ao redor da cena a 60fps em uma única rotação suave, a luz neon refrata em cada minúscula superfície reflexiva — bordas de monitores, caneca de café, piso de ladrilho brilhante. Raios de luz volumétricos dos tubos de neon criam uma névoa suave acima da cena. D
…
[truncado para tradução]