Generate images

Use executors/generate-image/generate-image.mjs for text-to-image and reference-image editing. It is a repository-owned, zero-dependency Node.js client. Do not call Codex system Skills, private scripts, or files under ~/.codex.

Define the asset

Specify:

• placement and purpose;
• subject and visible action;
• composition and aspect ratio;
• visual style and brand palette;
• exact text when text is essential;
• details that must appear;
• artifacts, logos, watermarks, and unrelated text to exclude.

Prefer real product screenshots when the image explains product behavior. Use generated visuals for concepts, scenes, covers, illustrations, diagrams, and supporting examples.

Generate

Use a prompt file for long or multilingual prompts:

node executors/generate-image/generate-image.mjs \
  --out <output.png> --prompt-file <prompt.txt>

Choose OpenAI explicitly when appropriate:

node executors/generate-image/generate-image.mjs \
  --model gpt-image-2 --out <output.png> \
  --prompt-file <prompt.txt>

--model accepts any gpt-image-* ID (sent to the OpenAI Images API at OPENAI_BASE_URL) or any gemini-*image* / nano-banana* ID (sent to the Gemini API at GOOGLE_GEMINI_BASE_URL). Compatible gateways may expose suffixed or tiered model IDs; list them with the gateway's /v1/models before choosing.

Add one --ref <image> argument for each reference image used in an edit.

For JSONL batch generation, put one job per line with prompt or prompt_file, out, and optional model, refs, size, or quality:

node executors/generate-image/generate-image.mjs \
  --batch <jobs.jsonl> --out-dir <directory> --concurrency 3