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)