Showmeai Image, Video & 3D Generation
Generate images via Showmeai's OpenAI-compatible Images API (/images/generations), videos via Seedance API (/task/volces/seedance), or convert 2D images to 3D models (/task/gi/image-to-3d).
Basic Usage
CODEBLOCK0
Options
CODEBLOCK1
Video Generation
CODEBLOCK2
Image-to-3D Conversion
CODEBLOCK3
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
Video models (Seedance API):
- - doubao-seedance-1-5-pro-251215 ← default (supports audio, draft mode, text-to-video, image-to-video, first-and-last-frame)
3D models (Image-to-3D API):
- - Hunyuan3D-2 ← default (supports glb/stl output via type parameter)
- Hi3DGen (supports glb/stl output via fileformat parameter)
- Step1X-3D (supports glb/stl output via fileformat parameter)
Config
Set in .env or ~/.openclaw/openclaw.json:
- -
Showmeai_API_KEY — your Showmeai API key (required) - INLINECODE6 — base URL with /v1 suffix (required); defaults to
https://api.showmeai.art/v1 if not set
Save Behavior
Images:
- - Default: no local file, output
MEDIA:<url> directly - INLINECODE9 : save to INLINECODE10
- INLINECODE11 : save to INLINECODE12
- gpt-image models always save to media/ (API returns base64 only)
Videos:
- - Videos are saved when the API returns direct URL or base64 data
- For async task submission, the task ID is output
- Use
--save to ensure local saving when video is available
3D Models:
- - Conversion is async, returns a task ID
- Use
--query <task_id> to check status - Use
--query <task_id> --save to download when complete - Default save location: INLINECODE16
Video Prompt Parameters
New way (recommended): Use direct command-line parameters
- -
--resolution 480p/720p/1080p — video resolution - INLINECODE18 — aspect ratio
- INLINECODE19 — duration in seconds (use 0 for auto on 1.5 pro)
- INLINECODE20 — number of frames (alternative to duration)
- INLINECODE21 — add watermark
- INLINECODE22 — keep camera fixed
- INLINECODE23 — random seed for reproducibility
Old way (still supported): Append to prompt text
- -
--ratio 16:9 / INLINECODE25 - INLINECODE26 /
--rs 480p / INLINECODE28 - INLINECODE29 / INLINECODE30
- INLINECODE31 — disable fixed camera
Video specs: 24 FPS, durations 2-12s, resolutions 480P/720P/1080P.
Showmeai 图像、视频与3D生成
通过Showmeai兼容OpenAI的图像API（/images/generations）生成图像，通过Seedance API（/task/volces/seedance）生成视频，或将2D图像转换为3D模型（/task/gi/image-to-3d）。
基本用法
bash
python3 {baseDir}/scripts/gen.py --prompt 在此输入提示词
选项
bash
指定模型（默认：nano-banana-pro）
python3 {baseDir}/scripts/gen.py --prompt ... --model nano-banana-pro
更高分辨率（在模型名称后添加-2k或-4k）
python3 {baseDir}/scripts/gen.py --prompt ... --model nano-banana-pro-2k
本地保存图像（默认：不保存，仅返回URL）
python3 {baseDir}/scripts/gen.py --prompt ... --save
保存到OSS目录（~/.openclaw/oss/）
python3 {baseDir}/scripts/gen.py --prompt ... --oss
保存到自定义目录
python3 {baseDir}/scripts/gen.py --prompt ... --save --out-dir /path/to/dir
宽高比
python3 {baseDir}/scripts/gen.py --prompt ... --aspect-ratio 16:9
图像数量
python3 {baseDir}/scripts/gen.py --prompt ... --count 2
编辑图像（提供--input）
python3 {baseDir}/scripts/gen.py --prompt 让它看起来像一幅画 --input /path/to/image.jpg
视频生成
bash
基础文本转视频
python3 {baseDir}/scripts/video_gen.py --prompt 一名侦探进入昏暗的房间，检查桌上的线索
带参考图像（图像转视频）
python3 {baseDir}/scripts/video_gen.py --prompt 女孩抱着一只狐狸，睁开眼睛温柔地看着镜头 --image /path/to/image.jpg
首尾帧视频（需要两个帧）
python3 {baseDir}/scripts/video_gen.py --prompt 一只蓝绿色鸟变成人形 --first-frame /path/to/first.jpg --last-frame /path/to/last.jpg
无音频（更便宜）
python3 {baseDir}/scripts/video_gen.py --prompt ... --no-audio
草稿/预览模式（更快，质量较低）
python3 {baseDir}/scripts/video_gen.py --prompt ... --draft
保存到本地目录
python3 {baseDir}/scripts/video_gen.py --prompt ... --save --out-dir /path/to/dir
自定义分辨率、比例和时长
python3 {baseDir}/scripts/video_gen.py --prompt ... --resolution 1080p --ratio 16:9 --duration 10
带水印和固定摄像机
python3 {baseDir}/scripts/video_gen.py --prompt ... --watermark --camera-fixed
使用种子实现可复现结果
python3 {baseDir}/scripts/video_gen.py --prompt ... --seed 12345
图像转3D
bash
基础转换
python3 {baseDir}/scripts/image
to3d.py --image /path/to/image.png
自定义模型和格式
python3 {baseDir}/scripts/image
to3d.py --image character.png --model Hunyuan3D-2 --format glb
带纹理和更高质量
python3 {baseDir}/scripts/image
to3d.py --image character.png --texture --steps 10 --resolution 256
查询任务状态
python3 {baseDir}/scripts/image
to3d.py --query
完成后下载
python3 {baseDir}/scripts/imageto3d.py --query --save
支持的模型
nano-banana系列（返回URL，速度快）：
- - nano-banana
- nano-banana-pro ← 默认
- nano-banana-2
- nano-banana-pro-2k / nano-banana-pro-4k（高分辨率）
gpt-image系列（返回base64，始终保存）：
- - gpt-image-1
- gpt-image-1.5
视频模型（Seedance API）：
- - doubao-seedance-1-5-pro-251215 ← 默认（支持音频、草稿模式、文本转视频、图像转视频、首尾帧）
3D模型（图像转3D API）：
- - Hunyuan3D-2 ← 默认（支持通过type参数输出glb/stl）
- Hi3DGen（支持通过fileformat参数输出glb/stl）
- Step1X-3D（支持通过fileformat参数输出glb/stl）
配置
在.env或~/.openclaw/openclaw.json中设置：
- - ShowmeaiAPIKEY — 你的Showmeai API密钥 （必填）
- ShowmeaiBASEURL — 带/v1后缀的基础URL （必填）；未设置时默认为https://api.showmeai.art/v1
保存行为
图像：
- - 默认：不保存本地文件，直接输出MEDIA:
- --save：保存到~/.openclaw/media/
- --oss：保存到~/.openclaw/oss/
- gpt-image模型始终保存到media/（API仅返回base64）
视频：
- - 当API返回直接URL或base64数据时保存视频
- 对于异步任务提交，输出任务ID
- 使用--save确保在视频可用时本地保存
3D模型：
- - 转换为异步操作，返回任务ID
- 使用--query id>检查状态
- 使用--query id> --save在完成后下载
- 默认保存位置：~/.openclaw/media/
视频提示参数
新方式（推荐）： 使用直接命令行参数
- - --resolution 480p/720p/1080p — 视频分辨率
- --ratio 16:9/4:3/1:1/3:4/9:16/21:9/adaptive — 宽高比
- --duration 2-12 — 时长（秒），1.5 pro版本使用0自动设置
- --frames — 帧数（替代时长）
- --watermark — 添加水印
- --camera-fixed — 固定摄像机
- --seed — 用于可复现结果的随机种子
旧方式（仍支持）： 附加到提示文本中
- - --ratio 16:9 / --ratio adaptive
- --rs 720p / --rs 480p / --rs 1080p
- --dur 5 / --dur 10
- --cf false — 禁用固定摄像机
视频规格：24 FPS，时长2-12秒，分辨率480P/720P/1080P。
