liven — Imagem para Vídeo (Nuvem)
Dá vida a imagens estáticas usando o modelo de difusão de vídeo LTX-2.3 Fast executado na infraestrutura em nuvem da fal.ai. Forneça uma imagem e um prompt de movimento; o modelo gera um pequeno clipe de vídeo (6 a 20 segundos, dependendo das configurações).
O diretório da skill (onde este SKILL.md está) é referido como $SKILL_DIR abaixo.
Baseado em nuvem. Nenhuma GPU local necessária. Requer a variável de ambiente
FAL_API_KEY. Preços: $0,04/s para 1080p, $0,08/s para 1440p, $0,16/s para 4K.
Quando Usar
Use esta skill quando o usuário quiser:
- Animar uma foto ou ilustração em um pequeno vídeo sem GPU local
- Criar movimento cinematográfico a partir de uma imagem (ex.: zoom lento, panorâmica, oscilação de luz)
- Gerar conteúdo de vídeo para redes sociais a partir de fotos de produtos ou retratos
- Usar resoluções mais altas (até 4K) sem limitações de VRAM local
Configuração (apenas na primeira execução)
cd "$SKILL_DIR" && uv sync
Defina a variável de ambiente FAL_API_KEY:
export FAL_API_KEY="sua-chave-de-api-aqui"
Fluxo de Trabalho do Agente
1. Pergunte ao usuário
Antes de animar a(s) imagem(ns), preciso saber:
💬 Prompt de movimento (obrigatório)
Descreva o movimento desejado, ex.:
"aproximação cinematográfica lenta, luz da hora dourada, deriva sutil da câmera"
🎬 Configurações do clipe
- duration — duração do vídeo em segundos (padrão: 6, opções: 6, 8, 10, 12, 14, 16, 18, 20)
Nota: durações >10s suportam apenas 25 FPS e 1080p
- resolution — qualidade de saída (padrão: 1080p, opções: 1080p, 1440p, 2160p/4K)
- aspect_ratio — proporção de aspecto do vídeo (padrão: auto, opções: auto, 16:9, 9:16)
- fps — quadros por segundo (padrão: 25, opções: 24, 25, 48, 50)
- generate_audio — gerar áudio por IA para combinar com o vídeo (padrão: true)
📁 Diretórios de entrada / saída (padrão: ./input e ./output)
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.
3. Execute
cd "$SKILL_DIR" && uv run python scripts/img2vid.py --config config.json
4. Relate os resultados
Informe ao usuário:
- Caminhos dos arquivos de saída
- Duração e resolução do vídeo
- Estimativa de custo (baseada na duração e resolução)
- URLs de download direto (os vídeos são hospedados temporariamente na fal.media)
Referência de Configuração
| Chave | Valores | Padrão | Descrição |
|---|---|---|---|
input_dir | caminho | ./input | Pasta contendo as imagens de origem |
output_dir | caminho | ./output | Pasta de destino |
prompt | string | (obrigatório) | Descrição do movimento |
duration | inteiro | 6 | Duração do vídeo em segundos (6-20) |
resolution | string | 1080p | Resolução de saída: 1080p, 1440p, 2160p |
aspect_ratio | string | auto | Proporção de aspecto: auto, 16:9, 9:16 |
fps | inteiro | 25 | Quadros por segundo: 24, 25, 48, 50 |
generate_audio | booleano | true | Gerar áudio por IA para o vídeo |
end_image_url | string | null | Quadro final opcional para vídeos de transição |
Invocações Comuns
# Animar com um prompt de movimento (usa padrões: 6s, 1080p, 25fps)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "aproximação cinematográfica lenta, luz da hora dourada"
# Gerar um vídeo mais longo de 10 segundos
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "vento suave nas árvores" --duration 10
# Criar um vídeo vertical para redes sociais
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "movimento sutil de câmera" --aspect-ratio 9:16
# Qualidade 4K (custo mais alto: $0,16/s)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "zoom out cinematográfico" --resolution 2160p --duration 8
# Taxa de quadros mais alta para movimento mais suave
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "sequência de ação rápida" --fps 48
# Desabilitar geração de áudio
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "cena de meditação silenciosa" --no-audio
# Criar transição entre duas imagens
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "transição suave de transformação" \
--end-image /caminho/para/imagem_final.jpg
Saída
Cada imagem de entrada produz um clipe .mp4 no output_dir, nomeado
<nome_da_imagem>.mp4. O vídeo também é enviado temporariamente para a CDN da fal.media
e uma URL de download é fornecida na saída do console.
Os metadados do vídeo (resolução, fps, duração) são exibidos após a geração.
Tratamento de Erros
- FAL_API_KEY ausente → erro claro com instruções de configuração
- Formato de imagem inválido → erro com formatos suportados (PNG, JPEG, WebP, AVIF, HEIF)
- Erros de API → mensagem de erro propagada da fal.ai
- Problemas de rede → lógica de repetição com mensagens de erro claras
Referência de Preços
| Resolução | Preço por segundo |
|---|---|
| 1080p | $0,04 |
| 1440p | $0,08 |
| 2160p (4K) | $0,16 |
Exemplos:
- Vídeo de 6s a 1080p = $0,24
- Vídeo de 10s a 1080p = $0,40
- Vídeo de 10s a 4K = $1,60