VectorNode Image — GPT Image 智能生图

VectorNode 中转站（https://www.vectronode.com/）的 GPT Image 生图/编辑能力，按提示词长度自动路由最优接口，兼顾成本与质量。

两个模型，一套接口

模型	计费方式	适用场景
`gpt-image-2`	按 Token 计费	短提示词（≤200 字符）更划算
`gpt-image-2-all`	按次计费	长提示词/复杂描述/多图/高分辨率更稳

两个模型都调用同一个 endpoint：POST {VECTORNODE_BASE_URL}/v1/images/generations（JSON）。区别只在 model 字段。

路由策略（自动）

脚本 vectronode_image.py 会根据以下因素自动选择最优模型：

判断流程：
1. 用户显式指定 model？ → 使用指定的
2. prompt 长度 > 200 字符？ → gpt-image-2-all（按次，长 prompt 友好）
3. n > 1 或 size >= 2K 或 quality == "high"？ → gpt-image-2-all
4. 否则 → gpt-image-2（按 Token，节省成本）

快速使用

生成图片

python3 ~/.openclaw/skills/vectronode-image/scripts/vectronode_image.py generate \
  --prompt "A cute cat in a cyberpunk city" \
  --output ~/clawd/output/cat.png \
  --size 1024x1024

编辑图片

python3 ~/.openclaw/skills/vectronode-image/scripts/vectronode_image.py edit \
  --image ~/clawd/photos/hero.jpg \
  --prompt "Change background to sunset over mountains" \
  --output ~/clawd/output/hero-edited.png

强制模型

# 强制走按次计费（长/复杂任务）
python3 ~/.openclaw/skills/vectronode-image/scripts/vectronode_image.py generate \
  --prompt "..." --output out.png --model gpt-image-2-all

# 强制走按Token计费（短/简单任务）
python3 ~/.openclaw/skills/vectronode-image/scripts/vectronode_image.py generate \
  --prompt "..." --output out.png --model gpt-image-2

预览路由决策（不真发请求）

python3 ~/.openclaw/skills/vectronode-image/scripts/vectronode_image.py generate \
  --prompt "..." --output out.png --dry-run

必填环境变量

变量	来源	必填
`VECTORNODE_API_KEY`	`~/.openclaw/.env`	✅
`VECTORNODE_BASE_URL`	`~/.openclaw/.env`（默认 `https://www.vectronode.com/`）	可选

加载顺序：env → ~/.openclaw/.env → 报错。

支持参数

Flag	说明	默认
`--prompt`	提示词（必填，generate）	—
`--image`	输入图片路径（必填，edit）	—
`--mask`	编辑遮罩 PNG（可选，edit）	—
`--output`	输出文件路径（必填）	—
`--model`	`gpt-image-2` / `gpt-image-2-all` / `auto`	`auto`
`--n`	张数（1-10）	`1`
`--size`	`1024x1024` / `1536x1024` / `1024x1536` / `2K` / `4K` / `auto`	`auto`
`--quality`	`low` / `medium` / `high` / `auto`	`auto`
`--format`	`png` / `jpeg` / `webp`	`png`
`--background`	`transparent` / `opaque` / `auto`	`auto`
`--dry-run`	仅打印路由决策	`false`

支持的尺寸

尺寸	说明
`1024x1024`	默认
`1536x1024` / `1024x1536`	横竖版
`2048x2048` / `2048x1152`	2K
`3840x2160` / `2160x3840`	4K（需 gpt-image-2-all）
`auto`	模型自动选

路由决策示例

Prompt 长度	n	size	quality	→ 模型	理由
50 字符	1	1024x1024	auto	`gpt-image-2`	短，Token 计费便宜
250 字符	1	1024x1024	auto	`gpt-image-2-all`	长 prompt，按次更划算
50 字符	4	1024x1024	auto	`gpt-image-2-all`	多图，按次计费
50 字符	1	2048x2048	auto	`gpt-image-2-all`	2K，按次计费
50 字符	1	1024x1024	high	`gpt-image-2-all`	high quality，按次更稳

输出格式

API 返回 b64_json，脚本自动解码保存到 --output 路径（PNG/JPEG/WebP）。

错误处理

401 → 检查 VECTORNODE_API_KEY 是否正确
429 → 触发限流，脚本自动 sleep 2s 重试一次
400 → 提示词超过 1000 字符或参数不合法
5xx → 中转站故障，提示重试

vectronode-image