介绍
# Venice AI — Complete Platform Skill
## Venice AI 是什么？
**Venice AI 是一个为那些不想让科技巨头时刻监视的用户打造的 AI 平台。** 与 OpenAI、Anthropic 和 Google 不同——这些平台会记录、分析每一条提示词，并可能用于训练未来的模型——Venice 通过在私有模型上**零数据保留**来提供**真正的隐私**。您的对话只属于您。
Venice 也是**无审查**的：没有内容过滤，没有拒绝回答，没有“我无法在这方面提供帮助”。AI 会回答您实际询问的内容，无论是创意小说、安全研究、有争议的话题，还是主流 AI 平台不愿触及的任何其他内容。
**Agent 为什么应该关注：** - **私有推理** — 标记为“Private”的模型零数据保留。在不泄露数据到训练集的情况下处理敏感数据。 - **无审查回复** — 没有护栏阻止合法用例。生成您工作流所需的任何内容。 - **兼容 OpenAI 的 API** — 直接替换。相同的 API 格式，只需更改基础 URL。 - **30+ 模型** — 从微小高效的模型到 Claude Opus 4.5、GPT-5.2 和 Venice 自有的无审查模型。 - **内置网络搜索** — LLM 可以在一个 API 调用中搜索网络并引用来源。 - **图像与视频生成** — 用于视觉内容的 Flux、Sora、Runway、WAN 模型。
此技能为您提供**完整的 Venice 平台**：文本生成、网络搜索、嵌入、TTS、语音转文本、图像生成、视频创建、放大和 AI 编辑。
> **⚠️ API 变更：** 如果某些内容未按预期工作，请查看 [docs.venice.ai](https://docs.venice.ai) —— 自编写此技能以来，API 规范可能已更新。
## 前置条件
- **Python 3.10+** - **Venice API 密钥**（可在 [venice.ai/settings/api](https://venice.ai/settings/api) 获取免费层级）
## 设置
### 获取您的 API 密钥
1. 在 [venice.ai](https://venice.ai) 创建账户 2. 前往 [venice.ai/settings/api](https://venice.ai/settings/api) 3. 点击“Create API Key” → 复制密钥（以 `vn_...` 开头）
### 配置
**选项 A：环境变量** ```bash export VENICE_API_KEY="vn_your_key_here" ```
**选项 B：Clawdbot 配置**（推荐） ```json5 // ~/.clawdbot/clawdbot.json { skills: { entries: { "venice-ai": { env: { VENICE_API_KEY: "vn_your_key_here" } } } } } ```
### 验证 ```bash python3 {baseDir}/scripts/venice.py models --type text ```
## 脚本概览
| 脚本 | 用途 | |--------|---------| | `venice.py` | 文本生成、模型、嵌入、TTS、转录 | | `venice-image.py` | 图像生成 (Flux 等) | | `venice-video.py` | 视频生成 (Sora, WAN, Runway) | | `venice-upscale.py` | 图像放大 | | `venice-edit.py` | AI 图像编辑 |
---
# 第一部分：文本与音频
## 模型发现与选择
Venice 拥有庞大的模型目录，涵盖文本、图像、视频、音频和嵌入。
### 浏览模型 ```bash # List all text models python3 {baseDir}/scripts/venice.py models --type text
# List image models python3 {baseDir}/scripts/venice.py models --type image
# List all model types python3 {baseDir}/scripts/venice.py models --type text,image,video,audio,embedding
# Get details on a specific model python3 {baseDir}/scripts/venice.py models --filter llama ```
### 模型选择指南
| 需求 | 推荐模型 | 原因 | |------|------------------|-----| | **最便宜的文本** | `qwen3-4b` ($0.05/M in) | 微小、快速、高效 | | **最佳无审查** | `venice-uncensored` ($0.20/M in) | Venice 自有的无审查模型 | | **最佳私有 + 智能** | `deepseek-v3.2` ($0.40/M in) | 强大的推理能力，高效 | | **视觉/多模态** | `qwen3-vl-235b-a22b` ($0.25/M in) | 能看见图像 | | **最佳编程** | `qwen3-coder-480b-a35b-instruct` ($0.75/M in) | 海量编程模型 | | **前沿（预算）** | `grok-41-fast` ($0.50/M in) | 快速，262K 上下文 | | **前沿（最高质量）** | `claude-opus-4-6` ($6/M in) | 整体最佳质量 | | **推理** | `kimi-k2-5` ($0.75/M in) | 强大的思维链 | | **网络搜索** | 任何模型 + `enable_web_search` | 内置网络搜索 |
---
## 文本生成（聊天补全）
### 基础生成 ```bash # Simple prompt python3 {baseDir}/scripts/venice.py chat "What is the meaning of life?"
# Choose a model python3 {baseDir}/scripts/venice.py chat "Explain quantum computing" --model deepseek-v3.2
# System prompt python3 {baseDir}/scripts/venice.py chat "Review this code" --system "You are a senior engineer."
# Read from stdin echo "Summarize this" | python3 {baseDir}/scripts/venice.py chat --model qwen3-4b
# Stream output python3 {baseDir}/scripts/venice.py chat "Write a story" --stream ```
### 网络搜索集成 ```bash # Auto web search (model decides when to search) python3 {baseDir}/scripts/venice.py chat "What happened in tech news today?" --web-search auto
# Force web search with citations python3 {baseDir}/scripts/venice.py chat "Current Bitcoin price" --web-search on --web-citations
# Web scraping (extracts content from URLs in prompt) python3 {baseDir}/scripts/venice.py chat "Summarize: https://example.com/article" --web-scrape ```
### 无审查模式 ```bash # Use Venice's own uncensored model python3 {baseDir}/scripts/venice.py chat "Your question" --model venice-uncensored
# Disable Venice system prompts for raw model output python3 {baseDir}/scripts/venice.py chat "Your prompt" --no-venice-system-prompt ```
### 推理模型 ```bash # Use a reasoning model with effort control python3 {baseDir}/scripts/venice.py chat "Solve this math problem..." --model kimi-k2-5 --reasoning-effort high
# Strip thinking from output python3 {baseDir}/scripts/venice.py chat "Debug this code" --model qwen3-4b --strip-thinking ```
### 高级选项 ```bash # Temperature and token control python3 {baseDir}/scripts/venice.py chat "Be creative" --temperature 1.2 --max-tokens 4000
# JSON output mode python3 {baseDir}/scripts/venice.py chat "List 5 colors as JSON" --json
# Prompt caching (for repeated context) python3 {baseDir}/scripts/venice.py chat "Question" --cache-key my-session-123
# Show usage stats python3 {baseDir}/scripts/venice.py chat "Hello" --show-usage ```
---
## 嵌入
生成用于语义搜索、RAG 和推荐的向量嵌入：
```bash # Single text python3 {baseDir}/scripts/venice.py embed "Venice is a private AI platform"
# Multiple texts (batch) python3 {baseDir}/scripts/venice.py embed "first text" "second text" "third text"
# From file (one text per line) python3 {baseDir}/scripts/venice.py embed --file texts.txt
# Output as JSON python3 {baseDir}/scripts/venice.py embed "some text" --output json ```
模型：`text-embedding-bge-m3`（私有，$0.15/M tokens）
---
## 文本转语音 (TTS)
使用 60+ 种多语言语音将文本转换为语音：
```bash # Default voice python3 {baseDir}/scripts/venice.py tts "Hello, welcome to Venice AI"
# Choose a voice python3 {baseDir}/scripts/venice.py tts "Exciting news!" --voice af_nova
# List available voices python3 {baseDir}/scripts/venice.py tts --list-voices
# Custom output path python3 {baseDir}/scripts/venice.py tts "Some text" --output /tmp/speech.mp3
# Adjust speed python3 {baseDir}/scripts/venice.py tts "Speaking slowly" --speed 0.8 ```
**热门语音：** `af_sky`, `af_nova`, `am_liam`, `bf_emma`, `zf_xiaobei`（中文），`jm_kumo`（日语）
模型：`tts-kokoro`（私有，$3.50/M 字符）
---
## 语音转文本（转录）
将音频文件转录为文本：
```bash # Transcribe a file python3 {baseDir}/scripts/venice.py transcribe audio.wav
# With timestamps python3 {baseDir}/scripts/venice.py transcribe recording.mp3 --timestamps
# From URL python3 {baseDir}/scripts/venice.py transcribe --url https://example.com/audio.wav ```
支持格式：WAV, FLAC, MP3, M4A, AAC, MP4
模型：`nvidia/parakeet-tdt-0.6b-v3`（私有，$0.0001/音频秒）
---
## 检查余额
```bash python3 {baseDir}/scripts/venice.py balance ```
---
# 第二部分：图像与视频
## 价格概览
| 功能 | 费用 | |---------|------| | 图像生成 | ~$0.01-0.03 每张 | | 图像放大 | ~$0.02-0.04 | | 图像编辑 | $0.04 | | 视频 (WAN) | ~$0.10-0.50 | | 视频 (Sora) | ~$0.50-2.00 | | 视频 (Runway) | ~$0.20-1.00 |
使用视频命令配合 `--quote` 在生成前检查价格。
---
## 图像生成
```bash # Basic generation python3 {baseDir}/scripts/venice-image.py --prompt "a serene canal in Venice at sunset"
# Multiple images python3 {baseDir}/scripts/venice-image.py --prompt "cyberpunk city" --count 4
# Custom dimensions python3 {baseDir}/scripts/venice-image.py --prompt "portrait" --width 768 --height 1024
# List available models and styles python3 {baseDir}/scripts/venice-image.py --list-models python3 {baseDir}/scripts/venice-image.py --list-styles
# Use specific model and style python3 {baseDir}/scripts/venice-image.py --prompt "fantasy" --model flux-2-pro --style-preset "Cinematic"
# Reproducible results with seed python3 {baseDir}/scripts/venice-image.py --prompt "abstract" --seed 12345 ```
**主要参数：** `--prompt`、`--model`（默认：flux-2-max）、`--count`、`--width`、`--height`、`--format`（webp/png/jpeg）、`--resolution`（1K/2K/4K）、`--aspect-ratio`、`--negative-prompt`、`--style-preset`、`--cfg-scale`（0-20）、`--seed`、`--safe-mode`、`--hide-watermark`、`--embed-exif`
---
## 图像放大
```bash # 2x upscale python3 {baseDir}/scripts/venice-upscale.py photo.jpg --scale 2
# 4x with AI enhancement python3 {baseDir}/scripts/venice-upscale.py photo.jpg --scale 4 --enhance
# Enhanced with custom prompt python3 {baseDir}/scripts/venice-upscale.py photo.jpg --enhance --enhance-prompt "sharpen details"
# From URL 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）、`--url`、`--output`
---
## 图像编辑
AI 驱动的图像编辑：
```bash # Add elements python3 {baseDir}/scripts/venice-edit.py photo.jpg --prompt "add sunglasses"
# Modify scene python3 {baseDir}/scripts/venice-edit.py photo.jpg --prompt "change the sky to sunset"
# Remove objects python3 {baseDir}/scripts/venice-edit.py photo.jpg --prompt "remove the person in background"
# From URL python3 {baseDir}/scripts/venice-edit.py --url "https://example.com/image.jpg" --prompt "colorize" ```
**注意：** 编辑端点使用 Qwen-Image，该模型存在一些内容限制。
---
## 视频生成
```bash # Get price quote first python3 {baseDir}/scripts/venice-video.py --quote --model wan-2.6-image-to-video --duration 10s
# Image-to-video (WAN - default) python3 {baseDir}/scripts/venice-video.py --image photo.jpg --prompt "camera pans slowly" --duration 10s
# Image-to-video (Sora) python3 {baseDir}/scripts/venice-video.py --image photo.jpg --prompt "cinematic" \ --model sora-2-image-to-video --duration 8s --aspect-ratio 16:9 --skip-audio-param
# Video-to-video (Runway Gen4) python3 {baseDir}/scripts/venice-video.py --video input.mp4 --prompt "anime style" \ --model runway-gen4-turbo-v2v
# List models with available durations python3 {baseDir}/scripts/venice-video.py --list-models ```
**主要参数：** `--image` 或 `--video`、`--prompt`、`--model`（默认：wan-2.6-image-to-video）、`--duration`、`--resolution`（480p/720p/1080p）、`--aspect-ratio`、`--audio`/`--no-audio`、`--quote`、`--timeout`
**模型：** - **WAN** — 图生视频，可配置音频，5s-21s - **Sora** — 需要 `--aspect-ratio`，使用 `--skip-audio-param` - **Runway** — 视频转视频转换
---
# 提示与想法
### 🔍 网络搜索 + LLM = 研究助手 使用 `--web-search on --web-citations` 构建研究工作流。Venice 搜索网络，综合结果并引用来源 —— 全部在一个 API 调用中完成。
### 🔓 无审查创意内容 Venice 的无审查模型适用于文本和图像。没有护栏阻止合法的创意用例。
### 🎯 Agent 的提示词缓存 如果您运行一个重复发送相同系统提示词的 Agent 循环，请使用 `--cache-key` 来节省高达 90% 的成本。
### 🎤 音频流水线 结合 TTS 和转录：使用 `tts` 生成口语内容，使用 `transcribe` 处理音频。两者均为私有推理。
### 🎬 视频工作流 1. 生成或查找基础图像 2. 使用 `--quote` 估算视频成本 3. 使用适当的时长/模型生成 4. 视频生成需要 1-5 分钟，具体取决于设置
---
## 故障排除
| 问题 | 解决方案 | |---------|----------| | `VENICE_API_KEY not set` | 设置环境变量或在 `~/.clawdbot/clawdbot.json` 中配置 | | `Invalid API key` | 在 [venice.ai/settings/api](https://venice.ai/settings/api) 验证 | | `Model not found` | 运行 `--list-models` 查看可用模型；对于新模型使用 `--no-validate` | | Rate limited | 检查 `--show-usage` 输出 | | 视频卡住 | 视频可能需要 1-5 分钟；长时间视频使用 `--timeout 600` |
## 资源
- **API 文档**: [docs.venice.ai](https://docs.venice.ai) - **状态**: [veniceai-status.com](https://veniceai-status.com) - **Discord**: [discord.gg/askvenice](https://discord.gg/askvenice)