autoGenImageSkill

Use when the user wants GPT-Image-2 image generation or image-to-image through an official OpenAI permission code/API key, a custom Responses-compatible proxy, or a reserved purchased-capacity relay.

Overview

Use this OpenClaw skill to generate PNG images with the local gpt_image relay pattern: a Responses API request uses text model gpt-5.4 plus an image_generation tool using gpt-image-2, then writes the returned base64 image to disk. The bundled CLI exposes three access paths so agents can pick the right entry without rewriting fetch/SSE/image decoding logic.

The main script is scripts/gpt_image_cli.js. Run it with Node 18+. In OpenClaw, reference it as {baseDir}/scripts/gpt_image_cli.js so the command works wherever the skill folder is located.

External pages:

• ClawHub / OpenClaw: https://clawhub.ai/Etherstrings/autogenimageskill
• Hermes Agent GitHub skill source: https://github.com/Etherstrings/autoGenImageSkill/tree/main/autoGenImageSkill

赞助支持

• 爱发电: https://ifdian.net/a/etherstrings
• GitHub donate section: https://github.com/Etherstrings/autoGenImageSkill#donate

Alipay:

WeChat Pay:

Access Choice

1. Use official when the user provides an official OpenAI permission code/API key or explicitly wants the official API path.
2. Use proxy when the user provides a custom base_url, proxy endpoint, provider name, or third-party Responses-compatible API key.
3. Use reserved when the user wants to use the creator's reserved capacity, purchase/redeem a key, check quota, or call the relay service that exposes /api/session, /api/keys, and /api/generate/jobs.

Do not echo API keys, permission codes, purchase keys, or provider tokens back to the user. Use environment variables or shell variables in examples.

Quick Commands

Official API key / permission code:

bash

node {baseDir}/scripts/gpt_image_cli.js generate \
  --mode official \
  --permission-code "$OPENAI_API_KEY" \
  --prompt "一张电影感的雨夜赛博城市街景" \
  --output output/cyber-rain.png

Custom proxy:

bash

node {baseDir}/scripts/gpt_image_cli.js generate \
  --mode proxy \
  --base-url "$GPT_IMAGE_BASE_URL" \
  --api-key "$GPT_IMAGE_API_KEY" \
  --prompt "透明背景的可爱机器人贴纸" \
  --size 1024x1024 \
  --output output/robot-sticker.png

Reserved purchased capacity:

bash

node {baseDir}/scripts/gpt_image_cli.js generate \
  --mode reserved \
  --service-url "$GPT_IMAGE_RELAY_URL" \
  --purchase-key "$GPT_IMAGE_PURCHASE_KEY" \
  --prompt "国风水墨质感的未来城市海报" \
  --output output/ink-future-city.png

Image-to-image:

bash

node {baseDir}/scripts/gpt_image_cli.js generate \
  --mode proxy \
  --base-url "$GPT_IMAGE_BASE_URL" \
  --api-key "$GPT_IMAGE_API_KEY" \
  --prompt "保持人物姿势，改成高端杂志封面摄影" \
  --image /absolute/path/reference.png \
  --output output/cover.png

Reserved Flow

For reserved capacity, create or reuse a session before generation when the user wants account persistence:

bash

node {baseDir}/scripts/gpt_image_cli.js session \
  --service-url "$GPT_IMAGE_RELAY_URL" \
  --profile-name "demo-user" \
  --save-session

Redeem a purchase key without generating:

bash

node {baseDir}/scripts/gpt_image_cli.js redeem \
  --service-url "$GPT_IMAGE_RELAY_URL" \
  --purchase-key "$GPT_IMAGE_PURCHASE_KEY" \
  --user-id "$GPT_IMAGE_USER_ID"

Check quota:

bash

node {baseDir}/scripts/gpt_image_cli.js quota \
  --service-url "$GPT_IMAGE_RELAY_URL" \
  --user-id "$GPT_IMAGE_USER_ID"

References

• Read references/access-modes.md when choosing among official, proxy, and reserved entries or when a user asks how to configure them.
• Read references/runtime.md when debugging generation, SSE parsing, relay quota, OpenClaw/Hermes packaging, or the relationship to the original gpt_image project.

Output Rules

Always return the absolute output image path and the decisive metadata: access mode, endpoint or relay job ID, provider name when available, byte size, and any revised prompt returned by the model. Keep credentials redacted.