VectorNode Image — GPT Image 智能生图 Skill

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 → 中转站故障，提示重试

Agent Skills: VectorNode Image — GPT Image 智能生图

Install this agent skill to your local

Skill Files