Generate Image

Gerar Imagem

Gere e edite imagens de alta qualidade usando os modelos de geração de imagens da OpenRouter, incluindo FLUX.2 Pro e Gemini 3 Pro.

Quando Usar Esta Skill

Use generate-image para:

• Fotos e imagens fotorrealistas
• Ilustrações artísticas e arte
• Arte conceitual e conceitos visuais
• Recursos visuais para apresentações ou documentos
• Edição e modificação de imagens
• Qualquer necessidade geral de geração de imagens

Use scientific-schematics para:

• Fluxogramas e diagramas de processo
• Diagramas de circuitos e esquemas elétricos
• Vias biológicas e cascatas de sinalização
• Diagramas de arquitetura de sistemas
• Diagramas CONSORT e fluxogramas de metodologia
• Qualquer diagrama técnico ou esquemático

Início Rápido

Use o script scripts/generate_image.py para gerar ou editar imagens:

# Gerar uma nova imagem
python scripts/generate_image.py "Um lindo pôr do sol sobre as montanhas"

# Editar uma imagem existente
python scripts/generate_image.py "Deixe o céu roxo" --input photo.jpg

Isso gera/edita uma imagem e a salva como generated_image.png no diretório atual.

Configuração da Chave de API

CRÍTICO: O script requer uma chave de API da OpenRouter. Antes de executar, verifique se o usuário configurou sua chave de API:

1. Procure por um arquivo .env no diretório do projeto ou diretórios pai
2. Verifique OPENROUTER_API_KEY=<key> no arquivo .env
3. Se não encontrado, informe ao usuário que ele precisa:
   • Criar um arquivo .env com OPENROUTER_API_KEY=your-api-key-here
   • Ou definir a variável de ambiente: export OPENROUTER_API_KEY=your-api-key-here
   • Obter uma chave de API em: https://openrouter.ai/keys

O script detectará automaticamente o arquivo .env e fornecerá mensagens de erro claras se a chave de API estiver faltando.

Seleção de Modelo

Modelo padrão: google/gemini-3-pro-image-preview (alta qualidade, recomendado)

Modelos disponíveis para geração e edição:

• google/gemini-3-pro-image-preview - Alta qualidade, suporta geração + edição
• black-forest-labs/flux.2-pro - Rápido, alta qualidade, suporta geração + edição

Apenas para geração:

• black-forest-labs/flux.2-flex - Rápido e econômico, mas não tão alta qualidade quanto o pro

Selecione com base em:

• Qualidade: Use gemini-3-pro ou flux.2-pro
• Edição: Use gemini-3-pro ou flux.2-pro (ambos suportam edição de imagens)
• Custo: Use flux.2-flex apenas para geração

Padrões de Uso Comum

Geração básica

python scripts/generate_image.py "Seu prompt aqui"

Especificar modelo

python scripts/generate_image.py "Um gato no espaço" --model "black-forest-labs/flux.2-pro"

Caminho de saída customizado

python scripts/generate_image.py "Arte abstrata" --output artwork.png

Editar uma imagem existente

python scripts/generate_image.py "Deixe o fundo azul" --input photo.jpg

Editar com um modelo específico

python scripts/generate_image.py "Adicione óculos escuros à pessoa" --input portrait.png --model "black-forest-labs/flux.2-pro"

Editar com saída customizada

python scripts/generate_image.py "Remova o texto da imagem" --input screenshot.png --output cleaned.png

Múltiplas imagens

Execute o script várias vezes com diferentes prompts ou caminhos de saída:

python scripts/generate_image.py "Descrição da imagem 1" --output image1.png
python scripts/generate_image.py "Descrição da imagem 2" --output image2.png

Parâmetros do Script

• prompt (obrigatório): Descrição em texto da imagem a gerar ou instruções de edição
• --input ou -i: Caminho da imagem de entrada para edição (ativa modo de edição)
• --model ou -m: ID do modelo OpenRouter (padrão: google/gemini-3-pro-image-preview)
• --output ou -o: Caminho do arquivo de saída (padrão: generated_image.png)
• --api-key: Chave de API da OpenRouter (sobrescreve arquivo .env)

Exemplos de Casos de Uso

Para Documentos Científicos

# Gerar uma ilustração conceitual para um artigo
python scripts/generate_image.py "Visão microscópica de células cancerosas sendo atacadas por agentes de imunoterapia, estilo ilustração científica" --output figures/immunotherapy_concept.png

# Criar um visual para uma apresentação
python scripts/generate_image.py "Estrutura de dupla hélice de DNA com site de mutação destacado, visualização científica moderna" --output slides/dna_mutation.png

Para Apresentações e Pôsteres

# Fundo de slide de título
python scripts/generate_image.py "Fundo abstrato azul e branco com padrões moleculares sutis, estilo profissional de apresentação" --output slides/background.png

# Imagem hero do pôster
python scripts/generate_image.py "Configuração de laboratório com equipamento moderno, fotorrealista, bem iluminada" --output poster/hero.png

Para Conteúdo Visual Geral

# Imagens para website ou documentação
python scripts/generate_image.py "Colaboração profissional de equipe ao redor de um whiteboard digital, escritório moderno" --output docs/team_collaboration.png

# Materiais de marketing
python scripts/generate_image.py "Conceito futurista de cérebro de IA com redes neurais brilhantes" --output marketing/ai_concept.png

Tratamento de Erros

O script fornece mensagens de erro claras para:

• Chave de API faltante (com instruções de configuração)
• Erros de API (com códigos de status)
• Formatos de resposta inesperados
• Dependências faltantes (biblioteca requests)

Se o script falhar, leia a mensagem de erro e resolva o problema antes de tentar novamente.

Notas

• Imagens são retornadas como URLs de dados codificados em base64 e salvas automaticamente como arquivos PNG
• O script suporta tanto formatos de resposta images quanto content de diferentes modelos da OpenRouter
• O tempo de geração varia por modelo (tipicamente 5-30 segundos)
• Para edição de imagens, a imagem de entrada é codificada em base64 e enviada ao modelo
• Formatos de imagem de entrada suportados: PNG, JPEG, GIF, WebP
• Verifique os preços da OpenRouter para informações de custo: https://openrouter.ai/models

Dicas de Edição de Imagem

• Seja específico sobre quais mudanças você quer (ex: "mude o céu para cores de pôr do sol" vs "edite o céu")
• Faça referência a elementos específicos na imagem quando possível
• Para melhores resultados, use instruções de edição claras e detalhadas
• Tanto Gemini 3 Pro quanto FLUX.2 Pro suportam edição de imagens através da OpenRouter

Integração com Outras Skills

• scientific-schematics: Use para diagramas técnicos, fluxogramas, circuitos, vias
• generate-image: Use para fotos, ilustrações, arte, conceitos visuais
• scientific-slides: Combine com generate-image para apresentações visualmente ricas
• latex-posters: Use generate-image para visuais de pôsteres e imagens hero