Vmvia API

外观

Vmvia API · 完整手册

AI Coding 工具接入手册

Claude Code、Codex、OpenClaw 与各类外接客户端的接入参数、分组说明与排障记录。首次配置建议先走简易模式。

Claude Code 快速上手报错与踩坑▷ 视频教程
⌘Claude Code

安装、CC Switch 自定义配置、启动验证；cc_max 分组。

irm https://claude.ai/install.ps1 | iex▣Codex CLI / 桌面端

Node 18+ 与 Codex，Base URL 带 /v1；codex 或 codex-wending 分组。

npm install -g @openai/codex◎OpenClaw

本地网关接飞书 / Telegram，provider 需补 User-Agent。

npm install -g openclaw@latest
🔀CC Switch 统一配置一处管理 Claude Code、Codex、OpenClaw 的 Key 与地址。🔌外接接入JetBrains、Trae、自定义客户端的分组、Base URL、UA 对照。🛠报错与踩坑22 条 Claude Code / Codex 常见报错的根因与修复步骤。🔎Grok Search MCP为 Claude Code 接入 Grok 联网搜索，grok 分组即将上架。🖥Claude 桌面版桌面客户端「第三方推理」入口接入 Vmvia。📈模型广场48 个模型的分组、价格与端点，创建令牌前先看。

安装 / 启动卡住先看这里 ​

如果安装命令无法下载，或启动后报 ConnectionRefused / Connection error，大多是网络问题，按这个顺序自查：

  1. 开了代理的，先关掉再试。
  2. 没开代理的，开启代理再试。
  3. 仍不行，开启代理软件的 TUN / 网卡模式（系统级代理），而不是只开浏览器代理。
  4. 主站 www.vmvia.com 访问不畅时，把 Base URL 换成国内优化线路 api.vmvia.com，路径规则不变。

详细排查见 CC-009：API Error (Connection error.)。

30 秒上手 ​

按你要用的工具往下找，三条路线选一条即可。首次配置建议直接走简易模式。

简称说明：ccs 指 CC Switch，cc 指 Claude Code。

Claude Code ​

bash
# 1. 安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash     # macOS / Linux / WSL
irm https://claude.ai/install.ps1 | iex            # Windows PowerShell

# 2. 在 CC Switch 新建「自定义配置」：
#    Base URL = https://www.vmvia.com   API Key = sk-xxx   模型留空
#    令牌分组用 cc_max

# 3. 启动
claude

详细见 Claude Code 快速上手 · CC Switch 统一配置

Codex CLI ​

bash
# 1. 装 Node 18+ 和 Codex CLI
npm install -g @openai/codex

# 2. 在 CC Switch 新建「自定义配置」（框架选 Codex）：
#    Base URL = https://www.vmvia.com/v1   model = gpt-5.6-sol
#    令牌分组用 codex 或 codex-wending

# 3. 启动
codex

详细见 Codex CLI 快速上手 · Codex 桌面端配置

OpenClaw ​

bash
# 1. 安装并初始化
npm install -g openclaw@latest
openclaw onboard --install-daemon

# 2. 在 ~/.openclaw/openclaw.json 添加 provider
#    Codex:  baseUrl = https://www.vmvia.com/v1  + Codex CLI User-Agent
#    Claude: baseUrl = https://www.vmvia.com     + Claude CLI User-Agent

# 3. 重启网关
openclaw gateway restart

详细见 OpenClaw 配置

入口与线路 ​

控制台 / 令牌管理
https://www.vmvia.com/console/token
创建 API Key、选择分组、关闭「模型限制」
模型广场
https://www.vmvia.com/pricing
查看每个分组当前支持的模型与价格
API 主站地址
https://www.vmvia.com
Claude 类不带 /v1；Codex / OpenAI 兼容类加 /v1
国内优化线路
https://api.vmvia.com
主站访问不畅时替换域名即可，路径规则相同

站点公告里还列出了 Codex 包月商店 shop.vmvia.com 与兑换地址 sub.vmvia.com，那是另一套包月产品，本手册只覆盖按量付费站点 www.vmvia.com 的接入。

分组速查 ​

最近核对：2026-09-28，数据取自 模型广场。分组、倍率与模型后续可能调整，以登录后的模型广场和创建令牌时的可选列表为准。

令牌设置：创建或编辑令牌时，关闭「模型限制」，限制令牌可调用的模型有时会引发未知异常。不要选择 default 分组，它没有任何可用模型。

按用途选分组 ​

你要做什么选这个分组Base URL
在 Claude Code 里用 Claudecc_maxhttps://www.vmvia.com
在 IDE、Trae、OpenClaw 等第三方客户端里外接 Claudesale_kirohttps://www.vmvia.com
Codex CLI / Codex 桌面端 / 外接 Codexcodex（更稳定选 codex-wending）https://www.vmvia.com/v1
用 gpt-image 生图、改图gpt-imagehttps://www.vmvia.com/v1
DeepSeek、GLM、Kimi、通义、豆包等国产模型国模https://www.vmvia.com/v1
Grok 对话与联网搜索grok（即将上架，倍率暂定 0.3x）https://www.vmvia.com/v1

全部分组 ​

分组用途Base URL / 协议可用模型倍率
cc_max
Claude Code 专用
仅限在 Claude Code 客户端内部使用
站点说明：CC_MAX限制客户端（假一赔十）
https://www.vmvia.com
Anthropic Messages
claude-fable-5、claude-fable-5-1、claude-haiku-4-5、claude-haiku-4-5-20251001、claude-opus-4-5、claude-opus-4-5-20251101 等 14 个1.8x
sale_kiro
Claude 外接 · 低价
第三方客户端、IDE、网关等外接调用 Claude；内置 Prompt，支持 Thinking
站点说明：低价AWSQ（Kiro）逆向Claude（支持外部调用 有内置Prompt 支持Thinking）
https://www.vmvia.com
Anthropic Messages
claude-haiku-4-5-20251001、claude-opus-4-5-20251101、claude-opus-4-6、claude-opus-4-7、claude-opus-4-8、claude-opus-5 等 9 个0.3x
codex
Codex 专用
Codex CLI / Codex 桌面端 / 外接 Codex，纯 Pro 号池
站点说明：codex专用分组（纯pro号池）
https://www.vmvia.com/v1
OpenAI Responses
gpt-5.6-sol、gpt-6-astra、gpt-6-sol0.2x
codex-wending
Codex 稳定版
与 codex 分组相同模型，线路更稳定，倍率略高
站点说明：codex稳定专用分组（纯pro号池）
https://www.vmvia.com/v1
OpenAI Responses
gpt-5.6-sol、gpt-6-astra、gpt-6-sol0.35x
gpt-image
GPT 生图
gpt-image 系列图像生成 / 编辑，按次计费
站点说明：gpt画画分组
https://www.vmvia.com/v1
OpenAI Images
gpt-image-2、gpt-image-2.5、gpt-image-2.5-flare、gpt-image-2.5-sunburst1x
国模
国产模型
DeepSeek、豆包、GLM、Kimi、通义千问等，OpenAI 兼容协议
站点说明：国产模型
https://www.vmvia.com/v1
OpenAI Chat Completions
deepseek-v4-flash、deepseek-v4-flash-0731、deepseek-v4-pro、deepseek-v4-pro-0813、doubao-seed-2.0-lite、doubao-seed-2.1-turbo 等 27 个0.2x
grok
Grok即将上架
Grok 对话与联网搜索（grok-search-mcp）
站点说明：Grok 分组（即将上架，倍率暂定）
https://www.vmvia.com/v1
OpenAI Responses
—0.3x
default
默认分组请勿选择
无可用模型，创建令牌时请勿选择
站点说明：请勿选择，无模型
—
—
—3x

cc_max 只接受 Claude Code 客户端的请求，外接会被拒绝；sale_kiro 走 AWS Kiro 通道，内置了系统提示词，支持 Thinking，适合任意客户端。两者模型基本一致，按使用场景选即可。

各分组完整模型列表 ​

数据取自模型广场，核对于 2026-09-28，共 48 个模型。价格已乘以分组倍率，与模型广场显示一致；实际以站点为准。

cc_maxClaude Code 专用1.8x14 个模型
模型 ID厂商价格（含倍率）
claude-fable-5Anthropic$18.00 入 · $90.00 出 /1M
claude-fable-5-1Anthropic$18.00 入 · $90.00 出 /1M
claude-haiku-4-5Anthropic$1.80 入 · $9.00 出 /1M
claude-haiku-4-5-20251001Anthropic$1.80 入 · $9.00 出 /1M
claude-opus-4-5Anthropic$9.00 入 · $45.00 出 /1M
claude-opus-4-5-20251101Anthropic$9.00 入 · $45.00 出 /1M
claude-opus-4-6Anthropic$9.00 入 · $45.00 出 /1M
claude-opus-4-7Anthropic$9.00 入 · $45.00 出 /1M
claude-opus-4-8Anthropic$9.00 入 · $45.00 出 /1M
claude-opus-5Anthropic$9.00 入 · $45.00 出 /1M
claude-opus-5-5Anthropic$7.20 入 · $36.00 出 /1M
claude-sonnet-4-5-20250929Anthropic$5.40 入 · $27.00 出 /1M
claude-sonnet-4-6Anthropic$5.40 入 · $27.00 出 /1M
claude-sonnet-5Anthropic$3.60 入 · $18.00 出 /1M
sale_kiroClaude 外接 · 低价0.3x9 个模型
模型 ID厂商价格（含倍率）
claude-haiku-4-5-20251001Anthropic$0.30 入 · $1.50 出 /1M
claude-opus-4-5-20251101Anthropic$1.50 入 · $7.50 出 /1M
claude-opus-4-6Anthropic$1.50 入 · $7.50 出 /1M
claude-opus-4-7Anthropic$1.50 入 · $7.50 出 /1M
claude-opus-4-8Anthropic$1.50 入 · $7.50 出 /1M
claude-opus-5Anthropic$1.50 入 · $7.50 出 /1M
claude-sonnet-4-5-20250929Anthropic$0.90 入 · $4.50 出 /1M
claude-sonnet-4-6Anthropic$0.90 入 · $4.50 出 /1M
claude-sonnet-5Anthropic$0.60 入 · $3.00 出 /1M
codexCodex 专用0.2x3 个模型
模型 ID厂商价格（含倍率）
gpt-5.6-solOpenAI$1.00 入 · $8.00 出 /1M
gpt-6-astraOpenAI$2.00 入 · $10.00 出 /1M
gpt-6-solOpenAI$0.40 入 · $2.00 出 /1M
codex-wendingCodex 稳定版0.35x3 个模型
模型 ID厂商价格（含倍率）
gpt-5.6-solOpenAI$1.75 入 · $14.00 出 /1M
gpt-6-astraOpenAI$3.50 入 · $17.50 出 /1M
gpt-6-solOpenAI$0.70 入 · $3.50 出 /1M
gpt-imageGPT 生图1x4 个模型
模型 ID厂商价格（含倍率）
gpt-image-2OpenAI$0.100 / 次
gpt-image-2.5OpenAI$0.060 / 次
gpt-image-2.5-flareOpenAI$0.060 / 次
gpt-image-2.5-sunburstOpenAI$0.060 / 次
国模国产模型0.2x27 个模型
模型 ID厂商价格（含倍率）
deepseek-v4-flashDeepSeek$0.20 入 · $0.40 出 /1M
deepseek-v4-flash-0731DeepSeek$15.00 入 · $15.00 出 /1M
deepseek-v4-proDeepSeek$2.40 入 · $4.80 出 /1M
deepseek-v4-pro-0813DeepSeek$15.00 入 · $15.00 出 /1M
doubao-seed-2.0-lite字节跳动$0.12 入 · $0.12 出 /1M
doubao-seed-2.1-turbo字节跳动$0.90 入 · $4.50 出 /1M
doubao-seed-evolving字节跳动$1.80 入 · $9.00 出 /1M
glm-5智谱$0.80 入 · $3.60 出 /1M
glm-5.1智谱$0.80 入 · $0.80 出 /1M
glm-5.2智谱$1.60 入 · $5.60 出 /1M
glm-5.2-fast-preview智谱$3.20 入 · $11.20 出 /1M
glm-5.3智谱$1.60 入 · $5.60 出 /1M
kimi-k2.5Moonshot$0.80 入 · $4.20 出 /1M
kimi-k2.6Moonshot$1.30 入 · $5.40 出 /1M
kimi-k2.7-codeMoonshot$1.30 入 · $5.40 出 /1M
kimi-k3Moonshot$4.00 入 · $20.00 出 /1M
muse-spark-1.2-contributor讯飞$0.43 入 · $0.86 出 /1M
qwen-vl-ocr阿里巴巴$0.06 入 · $0.10 出 /1M
qwen3.5-omni-flash阿里巴巴$0.44 入 · $2.66 出 /1M
qwen3.5-omni-plus阿里巴巴$1.40 入 · $8.00 出 /1M
qwen3.5-plus阿里巴巴$0.16 入 · $0.96 出 /1M
qwen3.6-flash阿里巴巴$0.24 入 · $1.44 出 /1M
qwen3.6-max-preview阿里巴巴$1.80 入 · $10.80 出 /1M
qwen3.6-plus阿里巴巴$0.40 入 · $2.40 出 /1M
qwen3.7-max阿里巴巴$2.40 入 · $7.20 出 /1M
qwen3.8-flash阿里巴巴$0.16 入 · $0.54 出 /1M
qwen3.8-max阿里巴巴$2.40 入 · $7.20 出 /1M

价格与计费 ​

  • 站内以美元额度计价，模型广场上每张模型卡片显示的「输入 / 输出 / 缓存」价格已经乘过分组倍率，可以直接和官方价格对比。
  • 同一个模型在不同分组的价格 = 基准价 × 分组倍率。例如 claude-sonnet-5 在 cc_max（1.8x）与 sale_kiro（0.3x）下相差 6 倍。
  • gpt-image 分组按次计费，模型广场会显示每次调用的价格。
  • 充值比例、余额与用量以 控制台 显示为准。

外接调用 ​

外接调用时除了选对分组，还要按接入类型补 User-Agent，否则常见 403 block。规则与示例见 外接调用 User-Agent 说明，各客户端的落地步骤见 外接兼容与接入说明。

Vmvia API · 售后 QQ 群 1033966199

Copyright © 2026 vmvia.com