名称： venice-ai-media
描述： 通过 Venice AI 生成、编辑和放大图像；将图像转换为视频。支持文生图、图生视频（Sora, WAN）、图像放大和 AI 编辑。
主页： https://venice.ai
元数据：
{
"clawdbot":
{
"emoji": "🎨",
"requires": { "bins": ["python3"], "env": ["VENICE_API_KEY"] },
"primaryEnv": "VENICE_API_KEY",
"notes": "需要 Python 3.10 或更高版本",
"install":
[
{
"id": "python-brew",
"kind": "brew",
"formula": "python",
"bins": ["python3"],
"label": "安装 Python (brew)",
},
],
},
}

Venice AI 媒体工具

使用 Venice AI API 生成图像和视频。Venice 是一个无内容审查的 AI 平台，价格具有竞争力。

先决条件

• Python 3.10+ (brew install python 或系统自带 Python)
• Venice API 密钥（提供免费额度）
• requests 库（如果缺失，脚本会自动安装）

设置

1. 获取 API 密钥

1. 在 venice.ai 创建账户
2. 访问 venice.ai/settings/api
3. 点击 "Create API Key"
4. 复制密钥（以 vn_... 开头）

2. 配置密钥

选项 A：环境变量

export VENICE_API_KEY="vn_your_key_here"

选项 B：Clawdbot 配置（推荐 - 跨会话持久化）

添加到 ~/.clawdbot/clawdbot.json：

{
  skills: {
    entries: {
      "venice-ai-media": {
        env: {
          VENICE_API_KEY: "vn_your_key_here",
        },
      },
    },
  },
}

3. 验证设置

python3 {baseDir}/scripts/venice-image.py --list-models

如果看到模型列表，说明已准备就绪！

价格概览

使用视频命令时，可先通过 --quote 参数在生成前查询价格。

快速开始

# 生成图像
python3 {baseDir}/scripts/venice-image.py --prompt "日落时分威尼斯宁静的运河"

# 放大图像
python3 {baseDir}/scripts/venice-upscale.py photo.jpg --scale 2

# 使用 AI 编辑图像
python3 {baseDir}/scripts/venice-edit.py photo.jpg --prompt "添加太阳镜"

# 从图像创建视频
python3 {baseDir}/scripts/venice-video.py --image photo.jpg --prompt "平缓的镜头平移" --duration 5s

图像生成

python3 {baseDir}/scripts/venice-image.py --prompt "日落时分威尼斯宁静的运河"
python3 {baseDir}/scripts/venice-image.py --prompt "赛博朋克城市" --count 4
python3 {baseDir}/scripts/venice-image.py --prompt "肖像" --width 768 --height 1024
python3 {baseDir}/scripts/venice-image.py --prompt "抽象艺术" --out-dir /tmp/venice
python3 {baseDir}/scripts/venice-image.py --list-models
python3 {baseDir}/scripts/venice-image.py --list-styles
python3 {baseDir}/scripts/venice-image.py --prompt "奇幻" --model flux-2-pro --no-validate
python3 {baseDir}/scripts/venice-image.py --prompt "照片" --style-preset "Cinematic" --embed-exif

关键参数： --prompt、--model（默认：flux-2-max）、--count（对相同提示词使用高效的批量 API）、--width、--height、--format（webp/png/jpeg）、--resolution（1K/2K/4K）、--aspect-ratio、--negative-prompt、--style-preset（使用 --list-styles 查看选项）、--cfg-scale（提示词遵循度 0-20，默认 7.5）、--seed（用于可重现的结果）、--safe-mode（默认禁用以获取无审查输出）、--hide-watermark（仅在明确要求时使用 - 水印支持 Venice）、--embed-exif（将提示词嵌入图像元数据）、--lora-strength（0-100，适用于特定模型）、--steps（推理步数，取决于模型）、--enable-web-search、--no-validate（跳过模型检查，用于新/测试版模型）

图像放大

python3 {baseDir}/scripts/venice-upscale.py photo.jpg --scale 2
python3 {baseDir}/scripts/venice-upscale.py photo.jpg --scale 4 --enhance
python3 {baseDir}/scripts/venice-upscale.py photo.jpg --enhance --enhance-prompt "锐化细节"
python3 {baseDir}/scripts/venice-upscale.py --url "https://example.com/image.jpg" --scale 2

关键参数： --scale（1-4，默认：2）、--enhance（AI 增强）、--enhance-prompt、--enhance-creativity（0.0-1.0）、--replication（0.0-1.0，保留线条/噪点，默认：0.35）、--url（使用 URL 而非本地文件）、--output、--out-dir

图像编辑

python3 {baseDir}/scripts/venice-edit.py photo.jpg --prompt "添加太阳镜"
python3 {baseDir}/scripts/venice-edit.py photo.jpg --prompt "将天空改为日落"
python3 {baseDir}/scripts/venice-edit.py photo.jpg --prompt "移除背景中的人"
python3 {baseDir}/scripts/venice-edit.py --url "https://example.com/image.jpg" --prompt "上色"

关键参数： --prompt（必需 - AI 将解释要修改的内容）、--url（使用 URL 而非本地文件）、--output、--out-dir

注意： 编辑端点使用 Qwen-Image 模型，该模型有一些内容限制（与其他 Venice 端点不同）。

视频生成

# 首先获取价格估算（不生成）
python3 {baseDir}/scripts/venice-video.py --quote --model wan-2.6-image-to-video --duration 10s --resolution 720p

# 图生视频（WAN 2.6 - 默认）
python3 {baseDir}/scripts/venice-video.py --image photo.jpg --prompt "镜头缓慢平移" --duration 10s

# 图生视频（Sora）
python3 {baseDir}/scripts/venice-video.py --image photo.jpg --prompt "电影感" \
  --model sora-2-image-to-video --duration 8s --aspect-ratio 16:9 --skip-audio-param

# 列出模型（显示每个模型可用的时长）
python3 {baseDir}/scripts/venice-video.py --list-models

# 清理使用 --no-delete 下载的视频
python3 {baseDir}/scripts/venice-video.py --complete <queue_id> --model <model>

关键参数： --image（生成必需）、--prompt（生成必需）、--model（默认：wan-2.6-image-to-video）、--duration（取决于模型，见 --list-models）、--resolution（480p/720p/1080p）、--aspect-ratio、--audio/--no-audio、--skip-audio-param、--quote（价格估算）、--timeout、--poll-interval、--no-delete（保留服务器上的媒体文件）、--complete（清理之前下载的视频）、--no-validate（跳过模型检查）

进度： 生成过程中，脚本会根据 Venice 的平均执行时间显示预估进度。

模型说明

使用 --list-models 查看当前可用性和状态。模型会频繁更新。

图像： 默认模型为 flux-2-max。常见选项包括 flux、gpt-image 和 nano-banana 变体。

视频：

• WAN 模型：图生视频，可配置音频，多种时长（5s-21s）
• Sora 模型：需要 --aspect-ratio 参数，使用 --skip-audio-param

提示：

• 对于尚未列入模型列表的新模型或测试版模型，使用 --no-validate
• 生成视频前使用 --quote 检查价格
• 安全模式默认禁用（Venice 是无审查 API）

输出

脚本会打印 MEDIA: /path/to/file 行，供 Clawdbot 自动附加。

提示： 通过 iMessage 发送生成的媒体时，使用 --out-dir /tmp/venice-$(date +%s) 以确保在不同用户账户间可访问。

故障排除

"VENICE_API_KEY not set"

• 检查 ~/.clawdbot/clawdbot.json 中的配置
• 或导出环境变量：export VENICE_API_KEY="vn_..."

"Invalid API key"

• 在 venice.ai/settings/api 验证您的密钥
• 密钥以 vn_ 开头

"Model not found"

• 运行 --list-models 查看可用模型
• 对于新/测试版模型，使用 --no-validate

视频卡住/超时

• 视频生成可能需要 1-5 分钟，具体取决于模型和时长
• 对于较长的视频，使用 --timeout 600
• 在 venice.ai 检查 Venice 状态

"requests" 模块未找到

• 安装它：pip3 install requests