aixvaro

使用教程

一个令牌即可调用 Claude、GPT、DeepSeek、GLM 模型和 MiniMax-H3 视频生成,兼容 Claude Code、Codex 和所有 OpenAI 格式客户端。

OpenAI 格式 / Codex / 大多数客户端
https://aixvaro.com/v1
Claude Code / Anthropic 格式(不带 /v1)
https://aixvaro.com

快速开始

  1. 注册并登录,在「钱包」中充值额度。
  2. 打开 API 密钥 页面,点击 创建 API 密钥,填写名称并选择分组(见下一节)。
  3. 复制生成的 sk- 开头的密钥,按下面对应工具的方法填入即可。
密钥等同于你的余额,请勿公开分享。泄露后可在「API 密钥」页面删除并重新创建。
密钥只在当前页面中使用,不会上传或保存,刷新页面后需重新粘贴。

选择分组

创建密钥时需要选择分组,分组决定这个密钥能调用哪些模型:

claude-max · Claude max
仅 Claude 全系模型。使用 Claude Code 推荐选这个。
gpt-codex-pro · GPT codex pro
仅 GPT 全系模型。使用 Codex 推荐选这个。
deepseek · DeepSeek
仅 DeepSeek 的 deepseek-v4-pro、deepseek-v4-flash、deepseek-flash 三个模型,见 DeepSeek / GLM。
glm · GLM 智谱
仅 GLM 的 glm-5.3、glm-5.3-flash 两个模型,见 DeepSeek / GLM。
minimax · MiniMax-H3
仅 MiniMax-H3 视频生成,调用方式见 视频生成 API。
default · 全部模型
以上所有模型全部可用(Claude、GPT、DeepSeek、GLM、MiniMax-H3),适合聊天客户端或需要切换多家模型的场景。

不同分组的倍率以创建密钥时显示的为准,模型单价见 模型与价格。

Claude Code

使用 claude-max(或 default)分组的密钥。最快的方式是直接用一行命令启动:

终端中运行
ANTHROPIC_AUTH_TOKEN="sk-你的密钥" \
ANTHROPIC_BASE_URL="https://aixvaro.com" \
CLAUDE_CODE_DISABLE_1M_CONTEXT=1 \
claude

CLAUDE_CODE_DISABLE_1M_CONTEXT=1 让 Claude Code 使用标准上下文,避免默认开启的 100 万 token 长上下文带来的额外消耗,建议保留。

Claude Code 默认使用 Opus(能力最强也最贵)。日常编码想省钱,可在 Claude Code 内输入 /model 切换到 Sonnet,或用 ANTHROPIC_MODEL 指定默认模型,例如 claude-sonnet-5。

首次启动如果仍要求登录 Anthropic 账号,说明环境变量没有生效:确认是在设置变量的同一个窗口里运行 claude,或改用上面的永久配置。不要选择官方登录。

Codex(CLI / VS Code 插件 / 桌面 App)

Codex 命令行(CLI)、VS Code / Cursor 里的 Codex 插件、Codex 桌面 App 共用同一套配置:~/.codex/config.toml(服务商)和 ~/.codex/auth.json(密钥)。下面两步只需做一次,三种用法都能直接用,不需要设置环境变量。请使用 gpt-codex-pro(或 default)分组的密钥。

第 1 步:写入配置
mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
model = "gpt-6-sol"
model_provider = "aixvaro"

[model_providers.aixvaro]
name = "aixvaro"
base_url = "https://aixvaro.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
第 2 步:保存密钥
cat > ~/.codex/auth.json << 'EOF'
{"auth_mode": "apikey", "OPENAI_API_KEY": "sk-你的密钥"}
EOF

配置好后,按你使用的方式打开 Codex:

用法怎么打开
Codex CLI终端运行 codex(未安装可先运行 npm i -g @openai/codex)
VS Code / Cursor 插件在扩展商店搜索并安装 OpenAI 官方的「Codex」插件,打开侧边栏的 Codex 面板即可。如果写配置前编辑器已经开着,请重启一次
Codex 桌面 App安装 OpenAI 官方 Codex App 后直接打开。如果写配置前 App 已经开着,请完全退出后重新打开
不要点「Sign in with ChatGPT / 用 ChatGPT 登录」:它会覆盖第 2 步保存的密钥。如果插件或 App 仍然要求登录,说明 auth.json 没写对,重新执行第 2 步后重启即可。

默认模型是 gpt-6-sol。想换模型,修改 config.toml 里的 model(例如 gpt-6-astra、gpt-6-luna、gpt-5.6-sol),CLI 也可以直接用 codex -m gpt-6-astra。

CC Switch(一键切换供应商)

CC Switch 是一个免费的桌面小工具,能在 Claude Code、Codex、Gemini CLI 等的多个供应商之间一键切换。配好后,在它里面点一下就能把 Claude Code / Codex 切到本站,省去手动改配置文件。请使用最新版(4.0 及以上),旧版不会自动生成 Codex 的模型目录,桌面版菜单里会看不到模型。

方式一:从本站一键导入(推荐)

  1. 电脑先装好 CC Switch 并至少打开过一次(这样系统才认得一键导入链接)。
  2. 打开 API 密钥 页面,在要用的密钥那一行点右侧的 ⇄ 导入 CC Switch 按钮。
  3. 在弹窗里选应用(Claude 或 Codex),模型会按密钥所在分组自动填好,点「打开 CC Switch」。
  4. 浏览器询问是否打开 CC Switch 时点允许,再在 CC Switch 的确认框里点导入即可。

方式二:在 CC Switch 里手动添加

如果一键导入不方便,也可以在 CC Switch 里手动添加本站供应商:

  1. 打开 CC Switch,左边栏选 Claude Code 或 Codex,点右上角「添加供应商」,选「自定义配置」。
  2. 名称随意填(如 aixvaro);API Key 填你的 sk- 密钥;API 请求地址填下表对应的地址。
  3. 点「获取模型列表」,会自动拉取该密钥分组下的模型,全选后「应用」。如果列表里有多余的默认模型(如 gpt-5.6-sol),把它那一行删掉。
  4. 点「添加」保存,再点该供应商那一行的 ▶ 切换过去即可。
CC Switch 里选API 请求地址说明
Claude Codehttps://aixvaro.com用 claude-max 或 default 分组的密钥
Codexhttps://aixvaro.com/v1用 gpt-codex-pro / default 分组;GLM、DeepSeek 用对应分组的密钥
Codex 桌面版 / 插件看不到模型?Codex 的模型下拉菜单是读模型目录文件生成的,最新版 CC Switch 切换时会自动生成,无需手动处理。切换后请彻底退出 Codex 再重新打开(关窗口不够,桌面版要在托盘里退出、macOS 按 Cmd+Q),菜单里才会刷新出本站模型。
不要点「用 ChatGPT 登录」。本站用的是密钥,点登录会覆盖配置。
分组要对应。密钥是哪个分组,就只能用那个分组里的模型(见选择分组)。

聊天客户端

Cherry Studio、ChatBox、LobeChat、NextChat 等任何支持「OpenAI 兼容接口」的客户端都可以使用:

设置项填写
服务商类型OpenAI / OpenAI 兼容
API 地址https://aixvaro.com(若客户端要求完整路径则填 https://aixvaro.com/v1)
API 密钥你的 sk- 密钥(建议 default 分组)
模型点击「获取模型列表」自动拉取,或手动填写下方模型 ID

在 API 密钥 页面的「聊天」按钮里,也可以一键导入到 Cherry Studio 等客户端。

Claude API(Anthropic 原生格式)

使用官方 Anthropic SDK 或 Messages API,只需修改 base_url 和密钥。地址为 https://aixvaro.com(不带 /v1)。

import anthropic

client = anthropic.Anthropic(
    api_key="sk-你的密钥",
    base_url="https://aixvaro.com"
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
# 返回内容可能包含 thinking(思考)块,只取文字部分
print("".join(b.text for b in message.content if b.type == "text"))

认证使用 x-api-key 请求头(与官方 Anthropic API 相同),并需要带上 anthropic-version 请求头。

OpenAI 格式调用

Claude 和 GPT 模型都可以通过 OpenAI 兼容接口 https://aixvaro.com/v1 调用,使用 Authorization: Bearer 认证。

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://aixvaro.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-5",   # GPT 模型同样可用,例如 gpt-6-sol
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

DeepSeek / GLM

使用 deepseek、glm(或 default)分组的密钥。地址与上面相同,支持三种调用格式:

格式地址适用
OpenAI Chat Completionshttps://aixvaro.com/v1/chat/completions全部 DeepSeek / GLM 模型,聊天客户端、OpenAI SDK
Anthropic Messageshttps://aixvaro.com/v1/messages全部 DeepSeek / GLM 模型,Claude Code、Anthropic SDK
OpenAI Responseshttps://aixvaro.com/v1/responsesCodex
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://aixvaro.com/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",   # 或 glm-5.3、deepseek-v4-pro 等
    messages=[{"role": "user", "content": "你好!"}],
    max_tokens=2048
)
print(response.choices[0].message.content)
思考模型需要足够的 max_tokens:DeepSeek-V4 和 GLM-5 系列会先输出思考过程(在 reasoning_content 字段),max_tokens 太小时正文 content 可能为空,建议设为 1024 以上。

模型列表

调用时 model 填下表中的 ID。实时单价见 模型与价格。

系列模型 ID所属分组
Claude Fableclaude-fable-5-1 claude-fable-5claude-max · default
Claude Opusclaude-opus-5-5 claude-opus-5 claude-opus-4-8 claude-opus-4-7 claude-opus-4-6claude-max · default
Claude Sonnetclaude-sonnet-5 claude-sonnet-4-6claude-max · default
Claude Haikuclaude-haiku-4-5 claude-haiku-4-5-20251001claude-max · default
GPT-6gpt-6-astra gpt-6-sol gpt-6-lunagpt-codex-pro · default
GPT-5.xgpt-5.6-sol gpt-5.6-terra gpt-5.6-lunagpt-codex-pro · default
DeepSeekdeepseek-v4-pro deepseek-v4-flash deepseek-flashdeepseek · default
GLM 智谱glm-5.3 glm-5.3-flashglm · default
视频生成MiniMax-H3(接口不同,见 视频生成 API)minimax · default

常见问题

提示「No available channel for model … under group …」

当前密钥的分组里没有这个模型。例如 claude-max 分组的密钥不能调用 GPT,deepseek 分组的密钥不能调用 GLM。请换用对应分组的密钥,或使用 default 分组。

提示 401 / 无效的令牌

检查密钥是否完整复制(包含 sk- 前缀)、是否已被删除或过期。Claude Code 请确认环境变量已生效。

提示额度不足

账户余额或该密钥的额度已用完。到「钱包」充值,或在「API 密钥」中调高该密钥的额度上限。

Codex 报错 404 或连接失败

确认 base_url 是 https://aixvaro.com/v1(带 /v1),且 wire_api = "responses"。

Codex 一直显示「Reconnecting... 1/5」

通常是密钥不可用:分组不对(例如用了 claude-max 分组的密钥)、密钥错误或额度用完。Codex 不会显示具体原因,请换用 gpt-codex-pro 或 default 分组的密钥,并在控制台「使用日志」中查看报错。

Codex 插件 / 桌面 App 一直要求登录

说明没读到密钥:确认 ~/.codex/auth.json 已按 Codex 一节第 2 步写入、密钥完整,然后完全退出编辑器或 App 再打开。不要选择 ChatGPT 登录。

Windows 上 Codex 提示只读、无法修改文件

这是 Codex 自带沙箱在 Windows 上的限制,与接口无关。可以在 WSL 中运行 Codex;或在确认信任当前项目时使用 codex --sandbox danger-full-access(会允许 Codex 不经确认修改文件,请自行评估风险)。

DeepSeek / GLM 返回的内容是空的

这些是思考模型,先生成思考过程再生成正文。max_tokens 太小时额度全部用在思考上,正文为空。把 max_tokens 调到 1024 以上即可。

Claude Code 报错 404

ANTHROPIC_BASE_URL 不要带 /v1,应为 https://aixvaro.com。

联系客服

客服邮箱:[email protected]。充值、账单、接口报错等问题都可以发邮件,我们会在 24 小时内回复。请注明你的注册邮箱或用户名;接口报错请附上报错信息和请求时间。

在哪里查看用量和扣费?

控制台的「使用日志」中可查看每次调用的模型、Token 数与费用。

中文·PT