video-generator — Vídeo Multi-Modelo em Nuvem (Higgsfield)
Gera clipes de vídeo via Higgsfield — uma plataforma que agrega mais de 6 modelos líderes sob uma única API e conta de faturamento. Escolha o modelo certo para o equilíbrio entre custo e qualidade; o restante da interface é idêntico.
O diretório da skill (onde este SKILL.md reside) é referido como $SKILL_DIR abaixo.
Baseado em nuvem. Nenhuma GPU local necessária. Requer uma conta Higgsfield e chave de API de cloud.higgsfield.ai.
Modos
| Modo | Gatilho | O que acontece |
|---|---|---|
text-to-video | Nenhuma imagem em input/ | Gera vídeo a partir apenas do prompt |
image-to-video | Imagens presentes em input/ | Anima cada imagem em um clipe |
auto (padrão) | — | Escolhe o modo acima automaticamente |
Predefinições
A skill usa predefinições como camadas finas sobre o mesmo mecanismo de vídeo. Uma predefinição pode definir o modelo padrão, proporção, duração e prefixo do prompt. Valores de configuração explícitos ainda vencem.
| Predefinição | Melhor para | Modelo padrão | Proporção padrão |
|---|---|---|---|
cinematic (padrão) | Vídeo cinematográfico de uso geral | kling | 16:9 |
social-hook | Formato curto que prende a atenção | seedance | 9:16 |
motion-design-ad | Anúncios de movimento SaaS/produto | kling | 16:9 |
ecommerce-ad | Clipes promocionais de produto | kling | 9:16 |
brand-story | Narrativa de fundador/marca | kling | 16:9 |
product-360 | Vitrine isolada de produto | kling | 1:1 |
Regras do fluxo de trabalho:
- escolha uma predefinição antes de editar
config.json - verifique se a predefinição corresponde ao estilo de saída desejado
- se o usuário não escolher, mantenha a predefinição padrão e registre-a na configuração
- não empilhe o mesmo estilo duas vezes; se o prompt já corresponder à predefinição, mantenha o prompt como está
Modelos
| Chave | ID completo do modelo | Melhor para |
|---|---|---|
kling (padrão) | kling-video/v2.1/pro/image-to-video | Movimento realista, econômico |
seedance | bytedance/seedance/v1/pro/image-to-video | Sincronia de áudio nativa |
dop | higgsfield-ai/dop/standard | Física óptica do Cinema Studio |
dop-preview | higgsfield-ai/dop/preview | Cinema Studio (camada de visualização) |
Estes são os IDs de modelo confirmados na documentação oficial. Modelos adicionais (Sora, Veo, Wan, etc.) podem ser encontrados em cloud.higgsfield.ai/explore. Para adicionar um, insira-o em
MODEL_IDSemgenerate.pye adicione um alias--model.Os créditos são cobrados apenas por geração bem-sucedida; solicitações com falha e NSFW são reembolsadas.
Configuração (apenas na primeira execução)
cd "$SKILL_DIR" && uv sync
Obtenha as credenciais de cloud.higgsfield.ai (Chave de API + Segredo da API), então exporte-as usando uma destas formas:
# Opção A — combinada (recomendada)
export HF_KEY="sua-chave-api:seu-segredo-api"
# Opção B — variáveis separadas
export HF_API_KEY="sua-chave-api"
export HF_API_SECRET="seu-segredo-api"
Fluxo de Trabalho do Agente
1. Pergunte ao usuário
Antes de gerar o vídeo, preciso saber:
🎬 Modo
- texto-para-vídeo (apenas prompt) ou imagem-para-vídeo (coloque imagens em input/)
- padrão: detecção automática
🎛️ Predefinição (padrão: cinematográfica)
- cinematográfica · gancho-social · anúncio-design-movimento · anúncio-ecommerce · história-marca · produto-360
- verifique a escolha antes de escrever config.json
- se omitido, mantenha a predefinição padrão e registre essa escolha
🤖 Modelo (padrão: kling)
kling · seedance · dop · dop-preview
Recomendação: kling para velocidade/custo, seedance para qualidade
💬 Prompt (obrigatório)
Descreva o movimento ou cena, ex.:
"aproximação cinematográfica lenta, luz quente da hora dourada, deslocamento sutil da câmera"
⚙️ Configurações
- duração — duração do vídeo em segundos (padrão: 6, intervalo: 3–16)
- proporção — 16:9 · 9:16 · 1:1 (padrão: 16:9)
- resolução — 720p · 1080p (padrão: 1080p)
Aguarde a resposta do usuário antes de prosseguir.
2. Edite config.json
Escreva ou atualize $SKILL_DIR/config.json com base nas escolhas do usuário. Defina preset explicitamente, mesmo ao usar o padrão.
3. (apenas imagem-para-vídeo) Coloque as imagens
Copie as imagens de origem para $SKILL_DIR/input/. Formatos suportados: .jpg .jpeg .png .webp
4. Execute
cd "$SKILL_DIR" && uv run python scripts/generate.py --config config.json
5. Relate os resultados
Informe ao usuário:
- Caminho(s) do(s) arquivo(s) de saída em
output/ - Modelo usado e custo aproximado de créditos
- Duração e resolução do vídeo
Referência de Configuração
| Chave | Valores | Padrão | Descrição |
|---|---|---|---|
input_dir | caminho | ./input | Imagens de origem (apenas imagem-para-vídeo) |
output_dir | caminho | ./output | Onde os MP4s são gravados |
mode | auto · text-to-video · image-to-video | auto | Modo de geração |
preset | cinematic · social-hook · motion-design-ad · ecommerce-ad · brand-story · product-360 | cinematic | Camada de predefinição criativa |
model | kling · seedance · dop · dop-preview | kling | Qual modelo usar |
prompt | string | (obrigatório) | Descrição do movimento ou cena |
duration | inteiro 3–16 | 5 | Duração do vídeo em segundos |
aspect_ratio | 16:9 · 9:16 · 1:1 | 16:9 | Proporção de saída |
extra_params | objeto | {} | Parâmetros de passagem para a API do modelo |
Invocações Comuns
# Texto-para-vídeo com modelo padrão (kling)
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "tomada de drone sobre montanhas nubladas ao amanhecer" --duration 8
# Imagem-para-vídeo com Kling (coloque as imagens em input/ primeiro)
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "aproximação cinematográfica lenta, luz da hora dourada" --model kling
# Qualidade superior: Seedance
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "afastamento aéreo sobre uma cidade nublada ao amanhecer" --model seedance
# Vídeo vertical para Reels/TikTok
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "cabeça falante, fundo com bokeh natural" \
--aspect-ratio 9:16 --model kling
# Rascunho rápido: resolução mais baixa, clipe mais curto
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "revelação de produto em fundo escuro" \
--resolution 720p --duration 4 --model dop-preview
Saída
Cada trabalho grava um .mp4 em output_dir:
- texto-para-vídeo:
output.mp4 - imagem-para-vídeo:
<nome_imagem>.mp4por imagem de entrada
vs animate-image
animate-image | video-generator | |
|---|---|---|
| Provedor | fal.ai | Higgsfield |
| Modo | apenas imagem→vídeo | texto→vídeo + imagem→vídeo |
| Modelo | LTX-2.3 Fast (fixo) | Kling, Sora, Veo, Wan, Seedance, MiniMax |
| Velocidade | Muito rápida | Dependente do modelo |
| Resolução máxima | 4K | 1080p |
| Controles cinematográficos | Não | Via extra_params |
Use animate-image para clipes rápidos, baratos e de alta resolução a partir de imagens.
Use video-generator quando precisar de texto-para-vídeo, escolha de modelo ou controles de física do Cinema Studio da Higgsfield.
Notas da API
A skill se comunica diretamente com a API REST da Higgsfield (cloud.higgsfield.ai). Os caminhos dos endpoints do modelo são definidos em MODEL_ENDPOINTS no topo de generate.py. Se a Higgsfield atualizar uma rota, substitua via configuração "extra_params" ou atualize a constante — nenhuma outra alteração é necessária.