Ranger Image 2

gpt-image-2

Rules

• Resolve credentials in this order: environment variables first, then

  ~/.codex/ranger-image-2/config.json

  , then interactive

  --configure

  prompts when a terminal is available.
• Never echo, commit, or write API keys anywhere except the user-local Codex config file after explicit confirmation.
• Prefer

  scripts/generate_image.py

  instead of hand-writing one-off API callers.
• Use the API route for speed when the user rejects the Codex CLI

  --enable image_generation

  session-extraction skill as too slow.
• If

  CUSTOM_IMAGE_URL

  is set to a path such as

  https://host/api/image/generate

  , normalize the same origin to

  https://host/v1

  and call

  /v1/images/generations

  ; this workspace observed

  /api/image/generate

  returning 404 while

  /v1

  routes worked.
• Keep the user's prompt verbatim unless they ask for prompt polishing.

One-time configuration

OPENAI_API_KEY

OPENAI_BASE_URL

CUSTOM_IMAGE_URL

python skills/ranger-image-2/scripts/generate_image.py --configure

~/.codex/ranger-image-2/config.json

Quick start

python skills/ranger-image-2/scripts/generate_image.py `
  --prompt "Create a sunset afterglow..." `
  --out output/imagegen/sunset.png `
  --size 1536x1024 `
  --quality high `
  --force

OPENAI_BASE_URL

/v1

CUSTOM_IMAGE_URL

Workflow

1. Run

   scripts/generate_image.py --dry-run

   for a cheap configuration check.
2. If credentials or endpoint are missing and an interactive terminal is available, run

   scripts/generate_image.py --configure

   and let the user provide values; persist only after confirmation.
3. Save long prompts to a temporary prompt file to avoid shell quoting issues.
4. Run

   scripts/generate_image.py

   with

   --prompt-file

   or

   --prompt

   , choosing a workspace output path under

   output/imagegen/

   unless the user specified another path.
5. Validate the saved file: existence, non-zero byte size, and dimensions.

Validation snippets

Add-Type -AssemblyName System.Drawing
$path = 'output/imagegen/result.png'
$item = Get-Item -LiteralPath $path
$img = [System.Drawing.Image]::FromFile((Resolve-Path $path).Path)
try {
  [pscustomobject]@{
    Path = $path
    Bytes = $item.Length
    Dimensions = "$($img.Width)x$($img.Height)"
  } | ConvertTo-Json -Compress
} finally {
  $img.Dispose()
}

Troubleshooting

• 404 page not found

  on

  /api/image/generate

  : use the same host's

  /v1/images/generations

  route by deriving

  OPENAI_BASE_URL=https://host/v1

  .
• TLS errors from

  urllib

  : use the bundled script/OpenAI SDK path instead of raw

  urllib

  .
• Missing credentials in a non-interactive run: set environment variables or run

  python skills/ranger-image-2/scripts/generate_image.py --configure

  in a terminal.

• openai SDK is not installed

  : run

  python -m pip install openai

  in the active environment.
• Existing output path: pass

  --force

  or choose a new filename.