360 Secure SkillHub
360 安全技能中心

VVMAI Image Generator

调用 VVMAI 的 OpenAI 兼容 Images API 按文本提示词生成图片，默认模型 nano-banana-pro，可选 nano-banana 与 gpt-image 系列、宽高比、生成数量和 2k/4k 分辨率后缀。默认只输出图片链接，--save/--oss 可保存到本地目录，需配置 VVMAI_API_KEY。

leevigoo
leevigoo
热度 57.46
最近更新 2026-05-11 17:32:08
分类：创作依赖：代码执行 / 第三方 API / 读写文件应用场景：图像生成 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add vvmai-image-gen
Metadata
name
vvmai-image-gen
description
Generate images via VVMAI's OpenAI-compatible Images API. Supports nano-banana and gpt-image model series. Default model is nano-banana-pro. Images are NOT saved locally by default (URL only). Use --save flag when the user wants to keep the image.
homepage
https://api.vvmai.com
license
MIT
metadata
{"openclaw":{"emoji":"🎨","requires":{"bins":["python3"],"env":["VVMAI_API_KEY","VVMAI_BASE_URL"]},"primaryEnv":"VVMAI_API_KEY"}}

VVMAI Image Gen

Generate images via VVMAI's OpenAI-compatible Images API (/images/generations).

Basic Usage

python3 {baseDir}/scripts/gen.py --prompt "your prompt here"

Options

# Specify model (default: nano-banana-pro)
python3 {baseDir}/scripts/gen.py --prompt "..." --model nano-banana-pro

# Higher resolution (append -2k or -4k to model name)
python3 {baseDir}/scripts/gen.py --prompt "..." --model nano-banana-pro-2k

# Save image locally (default: NO save, URL only)
python3 {baseDir}/scripts/gen.py --prompt "..." --save

# Save to OSS directory (~/.openclaw/oss/)
python3 {baseDir}/scripts/gen.py --prompt "..." --oss

# Save to custom directory
python3 {baseDir}/scripts/gen.py --prompt "..." --save --out-dir /path/to/dir

# Aspect ratio
python3 {baseDir}/scripts/gen.py --prompt "..." --aspect-ratio 16:9

# Image count
python3 {baseDir}/scripts/gen.py --prompt "..." --count 2

Supported Models

nano-banana series (returns URL, fast):

  • nano-banana
  • nano-banana-pro ← default
  • nano-banana-2
  • nano-banana-pro-2k / nano-banana-pro-4k (high res)

gpt-image series (returns base64, always saved):

  • gpt-image-1
  • gpt-image-1.5

Config

Set in .env or ~/.openclaw/openclaw.json:

  • VVMAI_API_KEY — your VVMAI API key (required)
  • VVMAI_BASE_URL — base URL with /v1 suffix (required); defaults to https://api.vvmai.com/v1 if not set

Save Behavior

  • Default: no local file, output MEDIA:<url> directly
  • --save: save to ~/.openclaw/media/
  • --oss: save to ~/.openclaw/oss/
  • gpt-image models always save to media/ (API returns base64 only)