andreakeating1982/image-generation

Geração de imagens

Uma boa imagem cumpre seu propósito: vender, explicar, identificar ou decorar no local onde será usada. Decida o propósito e o caminho antes de escrever um prompt.

Escolha o caminho

A imagem deve...	Caminho
Plotar dados com eixos, escalas ou números reais	Gráfico Python (veja a skill data-analysis). Nunca uma imagem de IA
Mostrar fatos exatos: horários, preços, cronogramas, itinerários, tabelas de comparação ou especificações, listas de verificação	Layout HTML renderizado em PNG: references/static-layouts.md
Mostrar uma estrutura: fluxograma, sequência, organograma, arquitetura, mapa mental	Mermaid renderizado em PNG: references/static-layouts.md. Faça uma versão de IA polida depois apenas se solicitado
Ser um ativo visual: cartaz, anúncio, post social, miniatura, ilustração, foto de produto, personagem, conceito de logotipo, ícone, imagem de maquete de UI, infográfico com alguns fatos-chave	Imagem de IA: media_generate_image
Alterar uma imagem existente: editar, reestilizar, trocar o fundo, adicionar ou remover objetos, traduzir seu texto, combinar pessoas ou produtos, aumentar escala ou restaurar	Edição de IA: media_generate_from_images
Redimensionar, cortar, converter, comprimir ou emendar sem novo conteúdo	Pillow ou ffmpeg no sandbox
Ser uma página web funcional, aplicativo ou protótipo	Construa o software. Uma imagem é a entrega errada

Para pessoas, lugares, produtos ou eventos reais que o usuário queira ver como são, encontre fotos reais com a ferramenta search (tipo image). Não as gere.

Ferramentas

• media_generate_image(prompt, orientation) gera com o modelo de imagem que o usuário selecionou (GPT Image por padrão, que renderiza texto bem). orientation é square, landscape ou portrait.
• media_generate_from_images(prompt, image_urls, orientation) edita ou combina imagens. image_urls aceita URLs ou caminhos do sandbox como /home/user/uploads/photo.jpg. Passe várias imagens para combiná-las ("coloque a pessoa da primeira imagem na cena da segunda").
• Ler esta skill desbloqueia as ferramentas de mídia. Se ainda estiverem ausentes, chame media_generate com uma breve descrição.
• Cada imagem usa os créditos de imagem do usuário. Quando o limite do plano for atingido, informe e sugira um upgrade. Nunca recorra a desenhar a imagem com Python.

Briefing, depois prompt

Defina estes pontos antes de criar o prompt. Pergunte apenas o que você não pode razoavelmente assumir (geralmente texto exato, cores da marca ou fotos de referência):

• Propósito: o que a imagem deve alcançar e onde será usada (post em feed, hero do site, impresso, slide, loja de aplicativos).
• Formato: orientação e áreas seguras (texto longe das bordas, espaço para um título).
• Sujeito: a pessoa, produto, cena ou conceito específico.
• Estilo: fotográfico, ilustração, 3D, vetor plano, estilo da marca ou correspondente a uma referência.
• Texto: as palavras exatas, organizadas como título, subtítulo, rótulos e chamada para ação, ou "sem texto".
• Deve manter: identidade, forma do produto, logotipo, cores, tudo fora da edição.

Padrões de prompt para novas imagens, edições e cada cenário estão em references/prompt-recipes.md. Leia-o para algo além de uma única imagem simples.

Regras

• Texto em imagens. Coloque as palavras exatas entre aspas dentro do prompt e deixe o modelo renderizá-las. Mantenha-se a um título e algumas linhas curtas. Nunca gere um fundo em branco e depois digite texto sobre ele com Python. Para informações densas e exatas, use a rota de layout HTML.
• Consistência. Para um personagem ou produto recorrente, crie uma imagem mestre e, em seguida, derive outras poses e cenas a partir dela com media_generate_from_images.
• Conjuntos. Para pacotes de ícones, baralhos de cartas, variantes de produtos e séries de cartazes, faça uma imagem por item com a mesma frase de estilo. Não os combine em uma única folha a menos que solicitado.
• Edições mantêm todo o resto. Diga exatamente o que muda e o que deve permanecer igual (rosto, pose, produto, fundo, iluminação, cores).
• Ativos transparentes. As ferramentas retornam imagens opacas. Gere em um fundo sólido e simples que não apareça no sujeito e, em seguida, remova-o: uma chave de cor com Pillow para gráficos planos, ou pip install rembg e rembg i entrada.png saida.png para fotos. Verifique as bordas.
• Verifique uma vez, levemente. Olhe o resultado (file_view com a URL da imagem funciona). Confirme se a solicitação foi atendida e se o texto, nomes e números exigidos estão corretos.
• Nunca gere uma imagem novamente por conta própria. Cada imagem custa créditos. Se um resultado tiver um erro real (palavra errada, número errado, elemento faltando), mostre-o, diga em uma frase o que está errado e pergunte se deve criar uma versão corrigida. Gere novamente sem perguntar apenas quando o usuário disser para continuar corrigindo até ficar certo. O layout HTML não custa nada: corrija-os você mesmo.

Entrega

Mostre as imagens geradas na resposta como markdown, ![Título curto](url). Arquivos do sandbox (renderizações, imagens processadas) também podem ser incorporados por caminho, ![Gráfico](/home/user/out/grafico.png). Entregue os arquivos finais que o usuário deve manter com send_attachment. Após entregar, pare. Ofereça um próximo passo útil em vez de fazer variantes extras que ninguém pediu.