Geração de imagens através do Codex
O Claude escreve a direção de arte; o gpt-6.1-sol a executa literalmente com sua ferramenta de imagem integrada. O briefing é todo o teto de qualidade: a Sol não inventará detalhes faltantes bem, e não usará "julgamento" em perguntas em aberto. Decida tudo primeiro, depois escreva.
Engine e perfis de função
As imagens vêm da ferramenta image_gen integrada do Codex na conta ChatGPT Pro — sem API, sem custos
por imagem. Essa ferramenta aceita apenas prompt, imagens de referência e transparent_background; o servidor escolhe
o modelo de imagem, então modelos específicos (GPT Image 2.6 Sunburst / Flare, etc.) não podem ser selecionados aqui.
Nunca mude para uma chave de API ou fallback da CLI de imagem do Codex.
O controle específico de função vem de perfis em ~/.claude/skills/codex/image-profiles.json, passados com
-ImageProfile <nome>. Um perfil anexa notas de estilo de função ao briefing e pode forçar transparência:
| Perfil | Uso | Notas |
|---|---|---|
default | qualquer outra coisa | apenas o briefing |
photoreal | fotos de produto, banners principais, fotos editoriais | regras de realismo fotográfico |
illustration | arte de marketing/blog/onboarding | regras de ilustração coesas |
icon | ícones de app/UI, marcas, adesivos, sprites | transparente, padding, legibilidade a 32px |
ui-asset | mockups, visuais de dashboard, estados vazios | geometria nítida, sem micro-texto falso |
text-heavy | cartazes, capas, infográficos | tipografia exata primeiro |
-Transparent funciona com qualquer perfil. Adicione novas funções adicionando uma entrada (transparent, roles,
style_notes) ao JSON. O briefing ainda é a principal alavanca de qualidade: os perfis adicionam, nunca substituem.
Fluxo de trabalho
- Esclareça apenas o que realmente te bloqueia (propósito, onde será usado, tamanho/proporção, texto na imagem, cores da marca). Caso contrário, escolha padrões sensatos e os declare no briefing.
- Escreva o briefing em um arquivo na scratchpad (ex.:
brief-hero.md) usando o modelo abaixo. Preencha todas as seções; escreva "nenhum" em vez de omitir uma seção. - Execute:
Usepwsh -NoProfile -File "$HOME\.claude\skills\codex\scripts\codex.ps1" -Mode image ` -PromptFile <brief.md> -Out <projeto>\assets\<nome>.png [-ImageProfile icon] [-Transparent] ` [-Count 3] [-Images ref1.png,ref2.png]timeout: 600000. Várias imagens diferentes → uma execução em segundo plano por imagem (uma frota). - Verifique você mesmo: Leia cada arquivo
CODEX_IMAGE=e verifique-o contra a lista de verificação de aceitação. A autoverificação do Codex é uma afirmação, não uma prova. - Itere com
-Session <CODEX_THREAD_ID>e um breve briefing delta ("Mantenha tudo; mude apenas: ..."), ou faça uma edição direcionada passando a saída anterior com-Imagese um briefing de edição. - Entregue: mostre a imagem ao usuário (Read it / SendUserFile), forneça o caminho, e mencione que o ID da thread está disponível para iterações futuras.
Modelo de briefing (copie, preencha todos os campos)
# Propósito e uso
<para que serve esta imagem, onde aparece (banner principal, ícone de app, slide, impresso), público>
# Saída
- Proporção / tamanho: <ex.: 16:9 paisagem, 1:1 quadrado, 9:16 vertical; px alvo se conhecido>
- Formato/fundo: <opaco | fundo transparente | sólido #FFFFFF>
- Variantes: <1 | N, e como as variantes devem diferir>
# Assunto
<assunto(s) principal(is) em termos concretos: quem/o quê, quantidade, pose, expressão, ação, roupa/material,
idade/etnia apenas se relevante e especificado pelo usuário>
# Composição e câmera
- Enquadramento: <close-up | médio | aberto | vista superior | isométrico | ortográfico plano>
- Posicionamento: <posição do assunto (regra dos terços, centralizado), espaço negativo para texto de que lado>
- Câmera/lente (estilos fotográficos): <ex.: 50mm, f/2.8 profundidade de campo rasa, nível dos olhos>
- Primeiro plano / plano médio / fundo: <cada descrito>
# Estilo
- Meio: <fotorrealista | render 3D | vetor plano | line art | aquarela | pixel art | argila | isométrico ...>
- Referências em palavras: <era, movimento, textura, espessura de linha, nível de detalhe> (sem nomes de artistas vivos)
- Detalhamento da renderização: <formas mínimas | moderado | altamente detalhado>
# Cor e luz
- Paleta: <códigos hex com funções, ex.: primária #1E6FFF, destaque #FFC233, fundo #F5F5F7>
- Iluminação: <luz suave do dia pela esquerda | iluminação de estúdio três pontos | hora dourada | luz néon de borda>
- Clima: <calmo, energético, premium, divertido ...>
# Texto na imagem
<"nenhum" OU cada string textual entre aspas, com sensação da fonte (sans-serif geométrica bold), cor, posição, tamanho
relativo à imagem. Mantenha as strings curtas; ortografia e caixa exatas são importantes.>
# Deve incluir
- <elementos não negociáveis>
# NÃO deve incluir
- <marcas d'água, texto extra, dedos extras, logotipos de marcas reais, poluição, cores específicas ...>
# Instruções de edição (apenas ao editar uma imagem anexada)
- Imagem 1 é: <a imagem a editar | uma referência de estilo | uma referência de assunto>
- Mude: <exatamente o que>
- Preserve: <todo o resto que deve permanecer idêntico: layout, rostos, cores, texto>
# Lista de verificação de aceitação
- [ ] <verificações objetivas que o Claude vai confirmar: proporção, assunto presente, texto exato, paleta, sem X>
Dicas de composição para resultados fortes
- Substantivos concretos e atributos mensuráveis são melhores que adjetivos ("três canecas de cerâmica, verde sálvia fosco #9CAF88, sobre uma mesa de nogueira" ≫ "canecas bonitas e aconchegantes").
- Um ponto focal claro; diga onde o espaço vazio fica se texto for sobreposto depois.
- Para ícones/logos: planos, poucas cores, centralizados, padding generoso, sem texto a menos que solicitado, teste em tamanho pequeno.
- Para ativos de UI/marketing: especifique o texto exato, e mantenha o texto na imagem mínimo — texto real de UI é melhor adicionado no código.
- Para séries/conjuntos (sprites, pacotes de ícones, storyboard): escreva uma seção compartilhada de "bíblia de estilo" e reutilize-a
textualmente no briefing de cada item para que o conjunto mantenha consistência; gere um herói primeiro, aprove-o, depois
passe-o com
-Imagescomo referência de estilo para o restante. - Não solicite semelhanças de pessoas reais, personagens protegidos por direitos autorais ou logotipos de marcas reais.