Gerar Imagem
Cria imagens via OpenAI GPT Image 2. A autenticação é feita através do Codex CLI logado com uma conta ChatGPT, portanto a geração é coberta pela assinatura Plus do usuário. Não há chave de API OpenAI e nem cobrança separada por imagem.
Antes de começar
Este Skill não se comunica diretamente com a OpenAI. Ele chama o Codex CLI, e esse CLI já precisa estar instalado nesta máquina e já logado em uma conta ChatGPT com uma assinatura Plus ativa. Verifique com codex --version e execute codex login se não estiver logado. Não há chave de API para colar, e não há cobrança separada por imagem; as imagens são cobradas nessa assinatura.
Sem um Codex CLI logado, nada aqui funciona, e o script falha na primeira chamada em vez de produzir um arquivo.
Início rápido
# a partir do diretório deste Skill, onde seu agente o instalou
./scripts/generate-image.sh "um shiba inu usando óculos escuros, foto de estúdio"
Salva na pasta de saída resolvida (veja abaixo) como um PNG com slug, ex.
assets/images/um-shiba-inu-usando-oculos-escuros-foto-de-estudio.png.
Fluxo de trabalho
- Transforme a solicitação do usuário em um prompt forte em inglês. Siga a ordem de construção e as alavancas em PROMPTING.md (cena → sujeito → detalhes → invariantes → uso). Refine solicitações vagas antes de chamar; não passe uma frase simples quando o ativo for importante.
- Execute o script com o prompt. Opcionalmente, passe
--oute--name. - Informe o caminho salvo de volta ao usuário. Para alterações, itere em pequenos passos de variável única e reafirme as invariantes (veja PROMPTING.md).
Local de saída
Quando --out não é fornecido, o script resolve a pasta automaticamente:
| Condição | Pasta de destino |
|---|---|
./public/ existe (iniciativa web/app) | ./public/images/ |
| caso contrário | ./assets/images/ (criada se ausente) |
Isso estabelece uma convenção consistente assets/images/ entre projetos, ao mesmo tempo que respeita projetos web, onde as imagens devem ficar em public/ para serem servidas.
Opções
| Flag | Efeito |
|---|---|
--out <dir> | Escreve neste diretório em vez do padrão resolvido |
--out <arquivo>.png | Escreve neste caminho de arquivo exato |
--name <basename> | Usa este nome base em vez de slugificar o prompt |
Arquivos existentes nunca são sobrescritos: o script anexa -2, -3, ... como alternativa.
Nomenclatura de entregáveis
Essas saídas são ativos de trabalho, portanto recebem nomes funcionais curtos por padrão. Se uma imagem for um entregável para partes interessadas, passe um --name explícito seguindo a regra de nomenclatura de arquivos, ex.
--name "20260612_Hero Banner_v1".
Requisitos
- CLI
codexinstalado (brew install --cask codex) - Logado com uma conta ChatGPT:
codex login(Plus ou superior; a geração de imagens não está disponível no plano Gratuito)
O script verifica ambos e falha com uma mensagem clara se algum estiver ausente.