Venice MCP Server | Venice API Docs

Venice MCP Server 是 Venice 的官方 Model Context Protocol 服务器。它将 Venice API（聊天、图像、视频、音频、音乐、embeddings、web augment、character、crypto RPC 和 TEE 证明）以及账户操作（账单和 API 密钥）作为 45 个工具暴露给任何兼容 MCP 的 agent 调用。

GitHub: veniceai/venice-mcp-server

以 @veniceai/mcp-server 发布到 npm。MIT 许可。

45 个工具

覆盖每种 Venice 模态，外加账单、API 密钥和 TEE 工具

任何 MCP 宿主

Claude Desktop、Cursor、ChatGPT、LM Studio、Continue 等

钱包身份验证（可选）

带上 API 密钥，或通过 x402 用 SIWE 签名的钱包按次付费

快速入门

获取 Venice API 密钥

从 venice.ai/settings/api 生成。逐步说明请参阅 API 密钥指南。

将 Venice 添加到 MCP 宿主配置

将以下内容放入您的 MCP 宿主配置文件：

{
  "mcpServers": {
    "venice": {
      "command": "npx",
      "args": ["-y", "@veniceai/[email protected]"],
      "env": { "VENICE_API_KEY": "<your-venice-api-key>" }
    }
  }
}

常见配置路径：

宿主	路径
Claude Desktop (macOS)	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Desktop (Windows)	`%APPDATA%\Claude\claude_desktop_config.json`
Cursor	`~/.cursor/mcp.json`
LM Studio	`mcp.json`（从应用的 MCP 设置中获取）

重启您的 MCP 宿主

您的 agent 现在已具备聊天、图像、视频、音乐、TTS、ASR 以及 39 个其他 Venice 工具。

大多数 MCP 宿主只会传递在 env 块中显式列出的环境变量。系统级环境变量不会被继承。如果您在设置了 API 密钥后仍看到 402 错误，请仔细检查 VENICE_API_KEY 是否在配置的 env 中。

您将获得

45 个工具，覆盖每种 Venice 模态以及账户操作；3 个资源（venice://models、venice://styles、venice://voices）；3 个 prompt 模板（无审查研究、NSFW 创意写作、图像风格探索）。每个工具都声明了明确的 readOnlyHint、destructiveHint、idempotentHint 和 openWorldHint 注解，因此宿主可以无需提示直接运行查询类操作，并在执行任何破坏性操作（例如媒体清理或 crypto 中继）之前请求确认。

聊天与 embeddings

工具	说明
`venice_chat`	针对 Venice 完整 LLM 目录的 OpenAI 兼容聊天补全，支持文本/图像/音频/视频/文件块、结构化输出、函数工具、prompt 缓存和推理控制。调用为明文且非流式。
`venice_responses`	无状态的 OpenAI 兼容 Responses API，支持文本/图像输入和推理控制。此工具不暴露工具调用字段，且不支持 E2EE 模型。
`venice_embeddings`	计算文本输入的 embeddings。
`venice_chat_with_character`	按 slug 与 Venice character 聊天。

图像

工具	说明
`venice_image_generate`	生成图像（Flux 2、Lustify SDXL、Anime/WAI、Qwen Image、GPT Image、Nano Banana Pro 等），支持宽高比或宽度/高度、质量档位、prompt 增强、风格参考、web 搜索和变体。
`venice_image_edit`	用 prompt 编辑图像。
`venice_image_multi_edit`	用一个 prompt 同时编辑最多 8 张图像（合成 / 外扩绘制）。
`venice_image_upscale`	将图像放大 2–4 倍，支持 `creativity` 控制。
`venice_image_remove_bg`	移除图像背景。
`venice_image_styles`	列出图像风格预设。

视频

工具	说明
`venice_video_generate`	排队视频生成（Sora 2、Veo 3.1、Kling、Wan、LTX 2、Seedance、Runway Gen-4 等），支持图像、视频、音频、参考和元素输入。
`venice_video_status`	检查已排队视频作业的状态（`POST /video/retrieve`）。
`venice_video_complete`	将已完成视频标记为已下载并删除其服务器端媒体。仅在 Venice 确认删除后才报告删除结果。
`venice_video_quote`	在排队前获取价格报价。

音频（TTS / ASR）

工具	说明
`venice_tts`	文本转语音，支持克隆 voice、temperature 和情感标签。流式输出会被缓冲为一个完整的音频结果。
`venice_asr`	从 URL 转录音频，可选单词/字符级时间戳。较大的转录结果通过会话句柄分页获取。
`venice_voice_clone`	列出当前模型范围内的可用 voice，或从样本 URL 克隆 voice（返回供 `venice_tts` 使用的 `vv_<id>` 句柄）。
`venice_audio_quote`	获取音乐生成的价格报价。

音乐

工具	说明
`venice_music_generate`	排队音乐生成（`ace-step-15`、`elevenlabs-music`、`minimax-music-v2/v25/v26`、`stable-audio-25`、`mmaudio-v2-text-to-audio`、`elevenlabs-sound-effects-v2`），支持歌词、纯音乐、循环、voice、语言、速度和时长控制。
`venice_music_status`	检查已排队音乐作业的状态。
`venice_music_complete`	将已完成音乐作业标记为已下载。

Web augment

工具	说明
`venice_web_search`	使用 Brave（默认，零数据保留）或 Google（由 Venice 代理并匿名化）搜索 web。
`venice_web_scrape`	将一个 URL 抓取为 markdown。
`venice_text_parser`	从 PDF/DOCX/EPUB/PPTX/XLSX 提取文本。

目录与 character

工具	说明
`venice_list_models`	分页浏览各类型的实时模型目录，包含精简摘要、价格和能力标志。
`venice_model_details`	获取某个确切模型的完整信息：`model_spec` 约束、能力和定价。
`venice_model_traits`	将特征名称（`default`、`most_uncensored`、…）映射到当前的模型 ID。
`venice_model_compatibility_mapping`	将兼容的模型名称映射到 Venice 模型 ID。
`venice_list_characters`	列出公开的 Venice character，支持搜索、标签、模型和排序筛选。仅限 API 密钥。
`venice_get_character`	按 slug 获取一个公开 character。仅限 API 密钥。
`venice_character_reviews`	分页列出某个 character 的公开评价。仅限 API 密钥。

TEE 证明

工具	说明
`venice_tee_attestation`	使用您自己的 32 字节 nonce，获取支持 TEE 的文本模型的硬件证明证据（Intel TDX quote、可选的 NVIDIA 证据、签名密钥）。
`venice_tee_signature`	获取已完成 TEE 聊天请求 ID 对应的 enclave 签名载荷。

这两个 TEE 工具只返回提供方的证据：它们不会验证证据，也不会加密聊天。在信任 TEE 模型之前，请自行验证回传的 nonce、调试模式状态以及签名密钥绑定；请参阅验证 TEE 证明。此服务器会拒绝 enable_e2ee。

Crypto

工具	说明
`venice_crypto_networks`	列出 RPC 代理接受的实时网络 slug。
`venice_crypto_rpc`	将单个 JSON-RPC 请求或最多 100 个请求的批次代理到 Ethereum、Base、Arbitrum、Optimism、Polygon、Solana、Starknet、zkSync、Linea、BSC、Avalanche、Blast 等。

交易广播（eth_sendRawTransaction、eth_sendUserOperation、Solana sendTransaction、Starknet 写入）必须作为单个请求发送并附带 idempotency_key，且重试时必须复用同一个 key。

账单（admin 密钥）

工具	说明
`venice_billing_balance`	当前 USD、DIEM 和捆绑额度的可用余额。
`venice_billing_usage_analytics`	Beta 版，按日期、模型和 API 密钥汇总的用量（回溯期或自定义范围）。
`venice_billing_usage_history`	详细用量，支持游标分页以及 JSON 或 CSV 输出。

账单工具需要 ADMIN API 密钥。推理密钥无法调用这些端点，服务器会在本地直接失败，而不会回退到钱包 token。

API 密钥

工具	说明
`venice_list_api_keys`	列出活跃密钥的元数据，仅包含最后六个字符。仅限 admin 密钥。
`venice_get_api_key`	按密钥 ID 获取单个密钥的元数据、用量、余额和速率限制。仅限 admin 密钥。
`venice_api_key_rate_limits`	当前余额、访问状态、等级、过期时间以及按模型划分的速率限制。推理密钥或 admin 密钥均可。
`venice_api_key_rate_limit_logs`	最近 50 次超出速率限制的事件（实验性）。仅限 admin 密钥。

x402 钱包辅助

仅当您通过 x402 使用钱包而非 API 密钥进行身份验证时相关。

工具	说明
`venice_x402_balance`	检查 EVM 或 Solana 钱包地址的预付 x402 额度余额。
`venice_x402_top_up_info`	获取充值要求（网络、USDC 代币、接收方、最低金额）。无需参数。
`venice_x402_transactions`	列出 EVM 或 Solana 钱包地址近期的 x402 充值和扣款交易。

配置

服务器完全通过环境变量配置。

模型与请求

环境变量	默认值	备注
`VENICE_API_KEY`	(无)	您的 Venice API 密钥。最简单的设置。
`VENICE_DEFAULT_CHAT_MODEL`	`deepseek-v4-flash-0731`
`VENICE_DEFAULT_IMAGE_MODEL`	`flux-2-pro`
`VENICE_DEFAULT_TTS_MODEL`	`tts-kokoro`
`VENICE_DEFAULT_ASR_MODEL`	`openai/whisper-large-v3`
`VENICE_DISABLE_NSFW`	`0`	设置为 `1` 可从工具描述中移除 NSFW 能力说明。
`VENICE_HTTP_TIMEOUT_MS`	`60000`
`VENICE_SIWX_TOKEN`	(无)	x402 钱包模式身份验证 token。请参阅下方的 x402。

如果同时设置了 VENICE_API_KEY 和 VENICE_SIWX_TOKEN，大多数调用将优先使用 API 密钥；例外情况请参阅身份验证模式覆盖范围。

响应大小限制

生成的媒体会被缓冲并以 base64 形式嵌入 MCP 结果中，因此每种模态都有字节上限。

环境变量	默认值	适用于
`VENICE_MAX_IMAGE_RESPONSE_BYTES`	`33554432` (32 MiB)	`venice_image_generate`、`venice_image_edit`、`venice_image_multi_edit`、`venice_image_upscale`、`venice_image_remove_bg`
`VENICE_MAX_VIDEO_RESPONSE_BYTES`	`26214400` (25 MiB)	`venice_video_status`
`VENICE_MAX_AUDIO_RESPONSE_BYTES`	`33554432` (32 MiB)	`venice_tts`、`venice_music_status`

超出大小的图像或 TTS 结果会被丢弃并返回错误。超出大小的视频或音乐结果会保留在队列中，因此您可以在提高限制后使用同一个队列 ID 再次调用状态工具。

HTTP 服务器

仅在 Streamable HTTP 部署中相关。

环境变量	默认值	备注
`PORT`	`3333`	HTTP 监听端口。
`VENICE_MCP_HOST`	`127.0.0.1`	绑定地址。设置为 `0.0.0.0` 可在局域网或容器中暴露。
`VENICE_MCP_AUTH_TOKEN`	(无)	`/mcp` 的 Bearer token。绑定在 loopback 之外时必须设置，且长度至少为 16 个字符。一旦设置，loopback 上也会强制校验。
`VENICE_MCP_ALLOW_UNAUTHENTICATED_HTTP`	`0`	允许暴露未经身份验证的 HTTP 的应急开关。仅在受信任且已做身份验证的代理之后使用。
`VENICE_MCP_MAX_SESSIONS`	`100`	活跃 Streamable HTTP 会话的最大数量。
`VENICE_MCP_SESSION_TTL_MS`	`1800000`	空闲会话在被清理前的存活时间。

媒体生成行为

已完成的媒体可能是字节数据或 URL。 视频和音乐作业会返回嵌入的 MP4/音频资源，或返回包含 download_url 的 JSON，该链接会作为资源链接返回。请先下载该链接，再调用 venice_video_complete 或 venice_music_complete；媒体清理永远不会应用于 download_url 结果，因为文件删除后该链接即失效。
部分模型仅在排队时返回 URL。 对于 VPS 和 Grok Imagine Private 模型，请保存 venice_video_generate 返回的 download_url 并将其传入 venice_video_status；即使 COMPLETED 的检索结果中没有内联 URL，也仍能得到可用的链接。
prompt 增强会回报结果。 应用 enhance_prompt 时，图像生成、编辑和多图编辑的结果会包含 Venice 返回的、经过 URL 解码的 prompt。
ASR 分页只计费一次。 超过 8,000 个字符的转录结果，或时间戳数量超出单页容量（默认每个数组 200 个，通过 timestamp_limit 最多 500 个）的转录结果，会随第一页返回一个 result_handle。使用该句柄请求后续页面。句柄按 MCP 会话保存在内存中，有效期 10 分钟，且只保留最近的 16 个。
Seedance 同意声明并不能绕过政策。 当前公开的 Seedance 模型可能会直接拒绝包含可识别人物的媒体。如果返回 needs_consent 响应，三个 consents.seedance 标志属于法律声明：只有在用户明确确认每项声明后，才能将其设置为 true。

x402 钱包模式

除了正常的 API 密钥流程外，Venice 还支持使用由 Base 或 Solana 上预付 USDC 额度支持的 Sign-In-With-X 钱包 token进行身份验证。无需邮箱、电话或 KYC：您的钱包是唯一的身份。

{
  "mcpServers": {
    "venice": {
      "command": "npx",
      "args": ["-y", "@veniceai/[email protected]"],
      "env": { "VENICE_SIWX_TOKEN": "<base64 Sign-In-With-X payload>" }
    }
  }
}

MCP 服务器在每次 Venice API 调用上将 VENICE_SIWX_TOKEN 作为 SIGN-IN-WITH-X 请求头转发。服务器永远看不到您的私钥。钱包签名和 USDC 充值授权在您自己的钱包中进行。

流程	发生什么
一次性设置	在钱包中签署一个 Sign-In-With-X 消息 → 产生一个 SIWX token（base64 JSON）。
充值	`POST /api/v1/x402/top-up` 返回 402 + 付款要求。签署其中一个返回的 Base 或 Solana 选项的 USDC 付款，重新提交，Venice 即为您的余额充值。
每次推理调用	MCP 服务器发送 `SIGN-IN-WITH-X: <SIWX>`；Venice 从您的预付余额中扣款。

最低充值为 $5 USD。调用推理的最低余额为 $0.10。充值后调用延迟低于 100ms，因为结算在一个快速额度账户上链下进行。

绑定到已质押 DIEM 的 Venice 账户的钱包将从质押余额而非 USDC 额度中消费，因此无需充值。

Venice 不接受推理路由上的付款请求头，因此此服务器永远不会发送付款请求头。PAYMENT-SIGNATURE 仅用于 /x402/top-up，而充值辅助工具只获取付款要求，不会提交付款。

身份验证模式覆盖范围

部分端点只接受一种身份验证模式：

工具	API 密钥	x402
推理、媒体、web augment、crypto RPC、character 聊天	✓	✓
`venice_list_characters`、`venice_get_character`、`venice_character_reviews`	✓	✗
`venice_billing_*`、`venice_list_api_keys`、`venice_get_api_key`、`venice_api_key_rate_limit_logs`	✓（admin）	✗
`venice_api_key_rate_limits`	✓（任意密钥）	✗
`venice_x402_balance`、`venice_x402_transactions`	✗	✓
`venice_x402_top_up_info`	✓	✓

同时设置两种凭证时，除 venice_x402_balance 和 venice_x402_transactions 始终发送钱包 token 外，所有需要身份验证的调用都使用 API 密钥。

自托管 (Streamable HTTP)

对于团队或工作区部署，通过 HTTP 而非 stdio 运行 MCP 服务器：

docker run -p 3333:3333 \
  -e VENICE_API_KEY=<your-venice-api-key> \
  -e VENICE_MCP_AUTH_TOKEN=<choose-a-long-random-token> \
  ghcr.io/veniceai/venice-mcp-server:latest

服务器现在可在 http://localhost:3333/mcp 访问。HTTP 客户端必须发送 Authorization: Bearer <VENICE_MCP_AUTH_TOKEN>，并应在不带 mcp-session-id 请求头的情况下创建新会话，然后复用服务器分配的会话 ID。

/mcp 是一个由凭证支持的工具执行端点：调用方可花费配置的 Venice API 密钥或 x402 余额。当 HTTP 模式绑定在 loopback 之外时，除非设置了 VENICE_MCP_AUTH_TOKEN，或在受信任且已做身份验证的代理之后设置了 VENICE_MCP_ALLOW_UNAUTHENTICATED_HTTP=1，否则启动会失败。对于生产环境，请显式锁定 npm 包版本，而不是依赖 latest。

资源

GitHub

源代码、issues 和发布

npm

@veniceai/mcp-server

Venice Skills

教 agent 如何使用这些工具的配套 skills

MCP 规范

了解更多关于 Model Context Protocol

GitHub: veniceai/venice-mcp-server

45 个工具

任何 MCP 宿主

钱包身份验证（可选）

​快速入门

​您将获得

​聊天与 embeddings

​图像

​视频

​音频（TTS / ASR）

​音乐

​Web augment

​目录与 character

​TEE 证明

​Crypto

​账单（admin 密钥）

​API 密钥

​x402 钱包辅助

​配置

​模型与请求

​响应大小限制

​HTTP 服务器

​媒体生成行为

​x402 钱包模式

​身份验证模式覆盖范围

​自托管 (Streamable HTTP)

​资源

GitHub

npm

Venice Skills

MCP 规范

快速入门

您将获得

聊天与 embeddings

图像

视频

音频（TTS / ASR）

音乐

Web augment

目录与 character

TEE 证明

Crypto

账单（admin 密钥）

API 密钥

x402 钱包辅助

配置

模型与请求

响应大小限制

HTTP 服务器

媒体生成行为

x402 钱包模式

身份验证模式覆盖范围

自托管 (Streamable HTTP)

资源