Guias · By AnyCap Team · 2026-07-11
Como adicionar geração de vídeo a um agente de IA
Agentes de IA escrevem código, respondem perguntas e automatizam fluxos, mas precisam de uma ferramenta de mídia para criar vídeo.
O AnyCap acrescenta essa capacidade com uma skill e uma CLI para que o agente descubra modelos, consulte schemas ativos, execute a geração e mantenha o arquivo baixado no mesmo fluxo.
Este guia abrange Claude Code, Cursor e Codex. Ele conecta a escolha da origem, a instalação, a descoberta de modelos, a validação do schema, a estrutura do prompt e o caminho de um único comando entre o pedido em linguagem natural e o vídeo concluído.
O objetivo prático é simples: depois da configuração, o agente pode tratar a geração de vídeo como outra chamada de ferramenta. O usuário pede um demo de produto, um conceito de movimento ou um clipe social curto, e o agente cuida da execução de ponta a ponta.
O que você precisa
A geração de vídeo termina em um único comando da CLI. Ela aguarda a conclusão no servidor, baixa a saída solicitada e imprime um JSON plano quando o comando termina; não é necessário executar outro comando depois.
- Um agente de IA capaz de executar comandos de shell, como Claude Code, Cursor ou Codex
- Node.js para o instalador de skills ou para a opção de instalação da CLI via npm
- Acesso ao fluxo de autenticação por navegador ou dispositivo escolhido pela CLI
- Um briefing em texto claro, uma imagem de origem ou um clipe existente para o primeiro teste
Escolha o fluxo a partir do material de origem
Comece pelo material que você já tem. Cada caminho usa um modo diferente, e o modelo escolhido precisa expor esse modo no catálogo ativo.
text-to-video
De briefing em texto para vídeo
Use uma descrição escrita da cena, do produto ou do movimento como única entrada criativa.
- Melhor uso
- Clipes novos quando o agente consegue descrever tema, ambiente, movimento e finalidade.
- Verifique antes
- O modelo não recebe uma âncora visual; inclua composição e direção de movimento concretas no prompt.
Schema ativo
anycap video models <model-id> schema --operation generate --mode text-to-videoGerar
anycap video generate --model <model-id> --mode text-to-video --prompt "a short product walkthrough" -o product-walkthrough.mp4image-to-video
De imagem de origem para vídeo
Anime uma imagem estática mantendo seu tema e sua composição como ponto de partida.
- Melhor uso
- Mockups, quadros de produto, artes principais ou outros visuais aprovados que precisam de movimento controlado.
- Verifique antes
- Envie a imagem local somente quando o schema do modo escolhido declarar o campo images.
Schema ativo
anycap video models <model-id> schema --operation generate --mode image-to-videoUse este parâmetro de mídia local somente quando o schema retornado o declarar: images
Gerar
anycap video generate --model <model-id> --mode image-to-video --prompt "animate this still with subtle camera movement" --param images=./source.png -o animated-source.mp4edit-video
De vídeo existente para versão editada
Transforme um clipe de origem preservando o tema útil e a continuidade de câmera.
- Melhor uso
- Revisões guiadas por prompt, como mudanças de luz, atmosfera ou tratamento visual.
- Verifique antes
- Este caminho aparece apenas enquanto houver um modelo edit-video no catálogo ativo, e o schema precisa declarar o campo videos.
Schema ativo
anycap video models <edit-model-id> schema --operation generate --mode edit-videoUse este parâmetro de mídia local somente quando o schema retornado o declarar: videos
Gerar
anycap video generate --model <edit-model-id> --mode edit-video --prompt "brighten the scene while preserving the subject and camera motion" --param videos=./source.mp4 -o edited-source.mp4Instale a skill do AnyCap
Instale a skill do AnyCap no agente que executará o fluxo. O comando específico do destino fornece instruções duradouras para escolher um modo, verificar o schema e chamar a CLI.
Instale a skill no seu agente
Escolha o comando correspondente ao agente que executará o fluxo. A skill fornece as instruções de operação; a CLI realiza a geração.
| Agente | Comando da skill |
|---|---|
| Claude Code | npx -y skills add anycap-ai/anycap -a claude-code -y |
| Cursor | npx -y skills add anycap-ai/anycap -a cursor -y |
| Codex | npx -y skills add anycap-ai/anycap -a codex -y |
Instale a CLI do AnyCap
Instale a CLI do AnyCap com o instalador via shell. O comando npm é uma alternativa; o Node.js é necessário nessa opção e no instalador de skills, mas não no binário independente da CLI.
curl -fsSL https://anycap.ai/install.sh | shnpm install -g @anycap/cliFaça login
Execute um único comando de login. A CLI escolhe o fluxo por navegador ou dispositivo conforme o ambiente, então a mesma configuração funciona localmente e em um shell remoto.
anycap loginDescubra os modelos de vídeo disponíveis
Liste o catálogo ativo de vídeo antes de escolher um modelo. Relacione o material de origem solicitado a um modo que o modelo selecionado exponha no momento.
anycap video modelsConsulte o schema ativo do modelo
Inspecione o schema de geração do modelo escolhido para o modo desejado. Adicione um parâmetro de imagem ou vídeo local somente quando esse schema declarar o campo correspondente.
Gere seu primeiro vídeo
Execute o comando de geração do caminho escolhido. A CLI aguarda a conclusão no servidor, baixa o arquivo e imprime um resultado JSON plano quando o comando termina.
Use geração de vídeo nos fluxos do agente
Agora o agente pode transformar o briefing em uma decisão de origem, selecionar um modelo compatível, validar seu schema, executar a geração e levar o arquivo baixado para revisão ou publicação.
Resultado concluído representativo
credits_used: 20 é ilustrativo. Os créditos reais variam conforme o modelo, a duração e as configurações de saída.
Saída JSON plana
{
"status": "success",
"local_path": "/workspace/product-walkthrough.mp4",
"model": "<model-id>",
"credits_used": 20,
"request_id": "req_abc123"
}Considere o resultado mostrado como representativo: a resposta real pode incluir campos adicionais, e o caminho local absoluto depende do diretório em que o comando é executado.
Onde a geração de vídeo ajuda mais
- Demos de produto
- Transforme notas de versão ou um resumo de recursos em um vídeo curto de demonstração que o agente gera durante a preparação do lançamento.
- Experimentos de marketing
- Peça ao agente variações curtas de um conceito de anúncio, animação principal ou teaser social sem sair do fluxo do terminal.
- Handoff de design
- Anime um mockup estático em um walkthrough para que a equipe revise movimento e narrativa mais cedo no ciclo de design.
Como conseguir resultados de vídeo melhores
A qualidade do prompt importa porque o modelo de vídeo precisa inferir composição, movimento, duração e continuidade visual. Um pedido curto e vago pode funcionar, mas um prompt estruturado costuma ser mais repetível.
Descreva o tema, o movimento de câmera, a cena, a iluminação, o tom e a duração desejada. Quando já houver um visual aprovado, escolha image-to-video para ancorar a composição no quadro de origem.
Peça primeiro ao agente um rascunho do prompt, revise-o e depois execute os comandos de schema e geração correspondentes. Assim, a aprovação criativa continua separada da execução sem interromper o fluxo.
Erros comuns de configuração e fluxo
- Pular a descoberta de modelos
- Os modelos expõem modos e compromissos diferentes. Execute anycap video models antes da escolha em vez de fixar o mesmo modelo para todos os pedidos.
- Usar prompts pouco específicos
- Um pedido como 'faça um vídeo do produto' é amplo demais. Acrescente contexto da cena, ritmo, direção de câmera e finalidade antes da geração.
- Supor que toda origem usa o mesmo schema
- Imagens e vídeos locais são parâmetros definidos pelo schema. Consulte o modo escolhido e adicione images ou videos somente quando o schema ativo declarar o campo.
Perguntas frequentes
Qual modo de vídeo o agente deve escolher?
Use text-to-video para um briefing escrito, image-to-video quando uma imagem deve ancorar o clipe e edit-video para um vídeo existente quando esse modo estiver no catálogo ativo.
Os comandos aceitam imagens e vídeos locais?
Sim, quando o schema ativo do modo escolhido declarar o campo images ou videos correspondente. Confira o schema antes de adicionar o parâmetro com o caminho local.
O comando de geração retorna antes de o vídeo ficar pronto?
Não. A CLI aguarda a conclusão no servidor, baixa o arquivo de saída e imprime o resultado quando o comando termina.
Toda geração de vídeo custa 20 créditos?
Não. O valor do exemplo é ilustrativo; o uso real varia conforme o modelo selecionado, a duração e as configurações de saída.
Versão e atualização da CLI · 0.6.5
Versão atual verificada em 21 de outubro de 2026: 0.6.5. Use o comando correspondente à instalação e confira a versão e o login no ambiente do agente.
Instalação binária
anycap updateInstalação npm
npm install -g @anycap/cli@latestanycap --version
anycap statusA versão 0.6.5 repete downloads transitórios, recupera links de vídeo expirados consultando a mesma tarefa e salva várias imagens em arquivos numerados. Após falha no download, retome a tarefa existente em vez de gerar novamente.
anycap video tasks wait <task-id> -o result.mp4Exemplos datados mantêm a versão, o resultado e o custo originais. Atualizar a CLI não revalida resultados antigos. Confira o schema e os preços atuais antes de uma nova tarefa paga.