分镜故事板生成器

Gerador de Storyboard para Histórias

Com base na história descrita pelo usuário, refine o enredo e divida-o em um storyboard, gerando em lote ilustrações visualmente consistentes para o storyboard.

Fluxo de Trabalho

Fase 1: Refinamento da História e Divisão em Storyboard

1. Receber História - Obter o conteúdo da história descrita pelo usuário (texto, esboço ou fragmento de inspiração)
2. Refinar o Enredo - Adicionar detalhes narrativos, organizar o arco emocional e gerar um resumo estruturado da história:

   Resumo da História: Resumo em uma frase
   Arco Emocional: [Início] → [Ponto de Virada] → [Desfecho]
   

3. Dividir em Storyboard - Dividir a história em 6 a 10 quadros-chave, cada um contendo:
   • Título da cena
   • Tipo de tomada (tomada ampla/tomada média/close-up/extreme close-up, etc.)
   • Descrição da cena (ação do personagem, ambiente, iluminação)
   • Tom emocional
   • Diálogo/texto (se houver)
4. Exibir o Storyboard - Apresentar em formato de tabela, aguardando confirmação ou ajustes do usuário

Formato de exibição:

## Storyboard

| # | Cena | Tomada | Descrição da Cena | Emoção |
|---|------|--------|-----------------|--------|
| 1 | Abertura | Tomada Ampla | xxx | Calmo |
| 2 | Introdução | Tomada Média | xxx | Curiosidade |
| ... |

Fase 2: Seleção de Estilo

Após a confirmação do storyboard, exibir 8 estilos visuais (ler references/visual-styles.md):

#	Estilo	Característica em uma Frase	História Adequada
1	História em Quadrinhos Cyberpunk	Néon + tons escuros + alto contraste	Tech/IA/Futuro
2	Aquarela Ghibli	Aquarela suave + luz e sombra acolhedoras	Cotidiano/Emocionante/Crescimento
3	Ilustração Plana Americana	Vetores geométricos + paleta de cores vivas	Produto/Negócios/Educação
4	Esboço de Storyboard Cinematográfico	Desenho a lápis preto e branco + anotações de câmera	Roteiro de vídeo/Anúncio
5	Pixel Art	Estilo retrô de jogo 16-bit	Jogos/Divertido/Geek
6	Pintura a Nanquim Chinesa	Nanquim suave + espaço em branco poético	Tradicional/Filosofia/Oriental
7	Mangá de Linha Limpa	Linhas grossas uniformes + cores chapadas	Aventura/Humor/PI
8	Arte Conceitual Realista	Pintura digital com qualidade cinematográfica	Épico/Ficção Científica/Fantasia

Com base no tipo de história e no tom emocional, recomendar 1-2 estilos mais adequados, explicando o motivo, e aguardar a seleção do usuário.

Fase 3: Geração de Prompts

Após o usuário selecionar o estilo, gerar prompts para cada quadro do storyboard.

Estrutura de cada prompt (ler references/visual-styles.md para obter o prefixo de estilo e a linguagem de câmera):

1. Prefixo de Estilo - Descrição padrão do estilo selecionado
2. Instrução de Tomada - Ex.: "Tomada de estabelecimento grande angular" / "Close-up"
3. Narrativa da Cena - Descrever o conteúdo da cena em frases completas (personagem, ação, ambiente, iluminação, atmosfera)
4. Instrução de Emoção - Especificar claramente a emoção que a cena deve transmitir
5. Âncora de Consistência - Importante: Este é o quadro número [N] de um total de [TOTAL] quadros do storyboard. Mantenha exatamente o mesmo estilo artístico, paleta de cores, design de personagens e consistência visual. O mesmo personagem em todos os quadros deve parecer idêntico.
6. Instrução em Chinês (se necessário) - Todo texto, logotipo e diálogo na imagem devem estar em chinês (mandarim simplificado). Termos técnicos podem permanecer em inglês.

Exibir tabela de resumo dos prompts, aguardando confirmação:

## Resumo dos Prompts

| # | Cena | Tomada | Estilo | Cena Principal |
|---|------|--------|--------|----------------|
| 1 | Abertura | Tomada Ampla | Cyberpunk | Horizonte urbano... |
| ... |

Após a confirmação, iniciar a geração (total de N quadros)

Fase 4: Geração em Lote

Após a confirmação, chamar o script para gerar quadro por quadro:

python3 scripts/generate_image.py \
  --prompt "prompt" \
  --output "/Users/ugreen/Documents/obsidian/09image/MMDD-nome-da-história-storyboard/01-nome-da-cena.png" \
  --api-key "AIzaSyDvvGGRbH4Os3Er0dYi0kE_AzE3_2b_Az8" \
  --api-url "https://generativelanguage.googleapis.com" \
  --model "gemini-3-pro-image-preview" \
  --aspect-ratio "16:9" \
  --resolution "2K"

Observações:

• O storyboard padrão usa o formato 16:9 (paisagem)
• Resolução padrão é 2K
• MMDD deve ser a data atual
• Nomenclatura de arquivos: 01-abreviatura-da-cena.png, 02-abreviatura-da-cena.png...
• Aguardar 2-3 segundos entre cada quadro para evitar limitação de taxa
• Registrar quadros com falha e continuar; relatar no final
• Crítico: A descrição da aparência do personagem deve ser consistente em todos os quadros (penteado, roupas, tipo físico)

Fase 5: Exibição e Iteração

1. Após a conclusão da geração, listar todos os caminhos dos quadros em ordem
2. Perguntar ao usuário:
   • "O ritmo geral da história está satisfatório?"
   • "Precisa regenerar algum quadro?"
   • "Precisa adicionar/remover alguma cena?"
   • "A consistência dos personagens está satisfatória?"
3. Iterar: ajustar o prompt e regenerar o quadro especificado

Especificações do Caminho de Salvamento

/Users/ugreen/Documents/obsidian/09image/MMDD-nome-da-história-storyboard/
├── 01-abertura-tomada_ampla.png
├── 02-introdução-tomada_média.png
├── 03-ponto_de_virada-close-up.png
├── 04-desenvolvimentoA-tomada_média.png
├── 05-desenvolvimentob-plano_geral.png
├── 06-clímax-extreme_close-up.png
├── 07-desfecho-tomada_ampla.png
└── storyboard-script.md  (opcional: salvar documento do script do storyboard)

Configuração da API

Item de Configuração	Valor
URL da API	https://generativelanguage.googleapis.com
Chave da API	AIzaSyDvvGGRbH4Os3Er0dYi0kE_AzE3_2b_Az8
Modelo	gemini-3-pro-image-preview
Proporção Padrão	16:9 (storyboard paisagem)
Resolução Padrão	2K

Referência Rápida de Linguagem de Câmera

Tomada	Termo em Inglês	Uso
Tomada Ampla	Tomada Grande Angular	Abertura, estabelecimento do ambiente
Plano Geral	Tomada de Corpo Inteiro	Corpo inteiro do personagem + ambiente
Tomada Média	Tomada Média	Diálogo, interações cotidianas
Close-up	Tomada de Close-up	Expressão facial, emoção
Extreme Close-up	Tomada de Extreme Close-up	Objeto-chave, detalhe
Plongée	Tomada de Vista Aérea	Visão geral, sensação de pequenez
Contra-Plongée	Tomada de Ângulo Baixo	Autoridade, impacto

Uso Comum

O Usuário Diz	Ação
"Cria um storyboard para minha história"	Coletar história → Refinar → Dividir em storyboard → Selecionar estilo → Gerar
"Transforma esta história em storyboard"	Mesmo que acima
"Desenha esta história no estilo cyberpunk"	Pular seleção de estilo, usar o estilo especificado diretamente
"O quadro 3 não ficou bom, regenera"	Ajustar o prompt e regenerar o quadro único
"Adiciona um quadro de transição"	Inserir um novo quadro de storyboard na posição especificada