VectorNode Image Generation Skill

VectorNode Image Generation

GPT Image (gpt-image-2) generation and editing via VectorNode relay API. Auto-routing: short prompts → token billing · long prompts → per-request billing.

Trigger

Use when: "生成图片", "generate image", "create illustration", "画一张", "编辑图片", "edit image", "GPT生图", "gpt image".

Quick Start

# Generation (auto-route billing)
python3 ~/.openclaw/skills/vectornode-image-gen/scripts/vectornode_gen.py \
  -p "你的提示词" \
  -o "/path/to/output.png"

# Edit existing image
python3 ~/.openclaw/skills/vectornode-image-gen/scripts/vectornode_gen.py \
  -p "add a sunset background" \
  -i "/path/to/input.png" \
  -o "/path/to/output.png"

# Force billing mode
python3 ~/.openclaw/skills/vectornode-image-gen/scripts/vectornode_gen.py \
  -p "long detailed prompt..." \
  -o "/path/to/output.png" \
  --billing per-request  # or token

Routing Logic

| Prompt Length | Billing | Model | Best For | |---|---|---|---| | < 300 chars | Token | gpt-image-2 | Simple prompts, quick iterations | | ≥ 300 chars | Per-request | gpt-image-2-all | Detailed prompts, content covers |

Threshold configurable via VECTORNODE_ROUTE_THRESHOLD env var (default: 300).

Parameters

| Flag | Required | Default | Description | |---|---|---|---| | -p, --prompt | ✅ | — | Image prompt (max 1000 chars for gen) | | -o, --output | ✅ | — | Output file path (.png/.jpg/.webp) | | -i, --image | ❌ | — | Input image for edit mode | | -m, --mask | ❌ | — | Mask image for edit (transparent areas = edit zone) | | -s, --size | ❌ | 1024x1024 | 1024x1024, 1536x1024, 1024x1536, 2048x2048, etc. | | -n, --count | ❌ | 1 | Number of images (1-10) | | -q, --quality | ❌ | auto | low, medium, high, auto | | --billing | ❌ | auto | auto, token, per-request | | --background | ❌ | auto | opaque, transparent, auto (edit mode only) | | --moderation | ❌ | auto | low, auto |

API Endpoints

| Mode | Endpoint | Method | Content-Type | |---|---|---|---| | Generate | /v1/images/generations | POST | application/json | | Edit | /v1/images/edits | POST | multipart/form-data |

Configuration

API credentials read from (in priority order):

Environment variables: VECTORNODE_API_KEY, VECTORNODE_BASE_URL
~/.openclaw/workspace/.env file

Supported Sizes

1024x1024 — Square (default)
1536x1024 — Landscape 3:2
1024x1536 — Portrait 2:3
2048x2048 — 2K Square
2048x1152 — 2K Landscape
3840x2160 — 4K Landscape
2160x3840 — 4K Portrait
auto — Model decides

Constraints: max dimension ≤ 3840px, aspect ratio ≤ 3:1, pixel range 655360–8294400.

Output Formats

png, jpeg, webp. Transparent background requires png or webp + --background transparent.

Workflow

Determine mode: has -i → edit, otherwise → generate
Auto-route billing if --billing auto:
- Prompt < threshold chars → token billing (gpt-image-2)
- Prompt ≥ threshold chars → per-request (gpt-image-2-all)
Call API, decode base64 response, save to output path
Return output path for downstream use

Integration with Content Workflow

When generating content covers, combine with content-cover-gen skill for prompt design:

1. Read content-cover-gen SKILL.md for visual metaphor methodology
2. Design prompt with visual metaphor + Chinese text
3. Call vectornode-image-gen with the designed prompt
4. Use output image as article cover

Error Handling

API errors surfaced with HTTP status + response body
Network timeout: 120s
Retry: 1 automatic retry on 5xx
Invalid image format: validated before upload (PNG < 50MB, mask PNG < 4MB)

Agent Skills: VectorNode Image Generation

Install this agent skill to your local

Skill Files