Wiro Image Fill

Overview

Generate real images via Wiro and write a mapping from placeholder keys to generated asset paths for later replacement.

How-to (quick start)

1. Get API credentials from Wiro dashboard for the target project.
2. Provide credentials using one of the options below.
3. Run the generator script with a prompt.
4. Use the mapping output to update image references.

Option A: export environment variables in the shell session.

export WIRO_API_KEY="your_project_api_key"
export WIRO_API_SECRET="your_project_api_secret"

Option B: create a

.env

file in the project root (user creates this file).

WIRO_API_KEY=your_project_api_key
WIRO_API_SECRET=your_project_api_secret

If

.env

does not exist, the script creates it with placeholder

WIRO_API_KEY

and

WIRO_API_SECRET

lines. The script reads

.env

by default if it exists. Use

--env-file path/to/.env

to point to a different file.

Workflow

1. Locate missing images.
2. Draft a prompt from nearby UI context.
3. Run the generator script.
4. Use the mapping to update image references.

1) Locate missing images

Use ripgrep to find placeholders:

rg -n "src=\"\"|src=''|placeholder\.png" <project-root>

Capture the placeholder key you will map (the literal placeholder string or path).

2) Draft a prompt

Use nearby UI copy, alt text, component names, and page intent. Keep the prompt short and specific to the UI need.

3) Run the generator script

Set credentials:

export WIRO_API_KEY="..."
export WIRO_API_SECRET="..."

Run per placeholder:

python3 scripts/wiro_generate_image.py \
  --model "google/nano-banana-pro" \
  --prompt "Modern dashboard hero showing analytics cards on a clean desk." \
  --map-key "placeholder.png"

Notes:

• Default output dir:

  public/generated

  if

  public/

  exists, else

  assets/generated

  , else

  generated/

  .
• Mapping file default:

  <output-dir>/image-map.json

  .
• Use

  --output-dir

  or

  --mapping-file

  to override.

• --input-image

  can be repeated or comma-separated.

• --body-mode multipart

  (default) sends multipart form fields; use

  --body-mode json

  if needed.
• IPv4 is preferred by default to avoid IPv6 delays. Use

  --ip-mode auto

  to disable IPv4 forcing.
• Timeouts:

  --connect-timeout

  (default 5s),

  --read-timeout

  (default 30s),

  --task-timeout

  (default 180s).

• --verbose

  prints run/poll progress to stderr; helpful for diagnosing stalls.
• Network retries use

  --request-retries

  (default 2) and

  --retry-wait

  (default 1s backoff).

4) Apply the mapping

Use the JSON mapping file to replace placeholders in code or templates. The script only writes the mapping entry when

--map-key

is provided.

References

Read

references/wiro_api.md

for endpoint and status details.

Scripts

• scripts/wiro_generate_image.py

  : Run Wiro generation, poll task status, download output, and update mapping.