Imagen – Habilidade de Geração de Imagens com IA
Visão Geral
Esta habilidade gera imagens usando o modelo de geração de imagens do Google Gemini (gemini-3-pro-image-preview). Permite a criação de imagens de forma integrada durante qualquer sessão do Claude Code — seja para criar UIs frontend, documentação ou visualizações de conceitos.
Multiplataforma: Funciona em Windows, macOS e Linux.
Quando Usar Esta Habilidade
Ative esta habilidade automaticamente quando:
- O usuário solicitar a geração de imagens (ex.: "gere uma imagem de...", "crie uma figura...")
- O desenvolvimento front-end exigir imagens placeholder ou reais
- A documentação precisar de ilustrações ou diagramas
- For necessário visualizar conceitos, arquiteturas ou ideias
- Estiver criando ícones, logotipos ou ativos de UI
- Qualquer tarefa em que uma imagem gerada por IA seja útil
Como Funciona
- Um prompt textual descrevendo a imagem desejada é fornecido
- A chamada à API do Google Gemini é feita com a configuração de geração de imagens
- A imagem gerada é salva no local especificado (padrão: diretório atual)
- O caminho do arquivo é retornado para uso no seu projeto
Uso
Python (Multiplataforma – Recomendado)
# Uso básico
python scripts/generate_image.py "Um horizonte de cidade futurista ao pôr do sol"
# Com caminho de saída personalizado
python scripts/generate_image.py "Um ícone de aplicativo minimalista para um player de música" "./assets/icons/music-icon.png"
# Com tamanho personalizado
python scripts/generate_image.py --size 2K "Paisagem em alta resolução" "./wallpaper.png"
Requisitos
- A variável de ambiente
GEMINI_API_KEYdeve estar configurada - Python 3.6+ (usa apenas a biblioteca padrão, nenhum pip install necessário)
Saída
As imagens geradas são salvas como arquivos PNG. O script retorna:
- Sucesso: Caminho para a imagem gerada
- Falha: Mensagem de erro com detalhes
Exemplos
Desenvolvimento Front-end
Usuário: "Preciso de uma imagem hero para minha landing page - algo abstrato e com foco em tecnologia"
-> Gera e salva a imagem, fornece o caminho para uso em HTML/CSS
Documentação
Usuário: "Crie um diagrama mostrando arquitetura de microsserviços"
-> Gera uma representação visual, pronta para README ou documentação
Ativos de UI
Usuário: "Gere uma imagem de avatar placeholder para o componente de perfil do usuário"
-> Cria uma imagem no tamanho apropriado para uso no componente