VBL-code 使用文档

快速开始

推荐测试模型：gpt-6-sol。

1. 注册并登录创建账户，完成邮箱验证，并由本人阅读、决定是否同意站点条款。
2. 开通权益已有激活码时前往 兑换激活码；余额按量用户先在「充值/订阅」中充值；需要套餐时前往 购买套餐。完成后检查权益是否生效。
3. 创建 API Key进入 API Key 管理，选择与你的模型、协议及权益对应的分组，保存并复制 Key。
4. 发起一次最小请求先确认 Key 的可用模型，再运行下方示例。示例调用会产生相应使用量。

curl https://sub2api.vibelearning.top/v1/responses \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-sol","input":"请只回复：连接成功"}'

注册、登录与开通

当前站点开放注册并开启邮箱验证。登录页会展示条款确认，未同意前账号密码输入与登录按钮不可用。

注册邮箱当前支持 Gmail、163、126、QQ、Outlook、Hotmail、iCloud、Yahoo、Foxmail。最终以注册页校验为准。

「充值/订阅」页面分为「充值」和「订阅」两个标签。充值页提供快捷金额、自定义金额和微信支付，输入额度以 $ 标示，应付金额以 ¥ 展示；最终换算以确认支付前的页面金额为准。充值余额用于标准分组，购买套餐用于对应的订阅分组。

Base URL

地址要与协议匹配。客户端的 Base URL 与完整请求路径是两个概念。

创建 API Key

登录后打开 API Key 管理，点击「创建密钥」，填写名称，依次选择厂商和分组。额度限制填 0 表示不设置该 Key 的消费上限。当前创建表单按「厂商 → 分组」选择权限，并提供用量上限、有效期及 IP 限制等设置。本次打开的创建表单没有独立的「选择订阅卡片」字段；订阅用户应选择权益对应的分组。具体可选项以你的账户页面为准。

保存后使用 Key 对应的「使用」或配置说明复制客户端设置。不要将完整 Key 放入截图、聊天记录或公共仓库。

Authorization: Bearer sk-your-key

环境检查

先确认工具已安装，再配置网关。仅选择 npm 安装时需要先准备符合工具要求的 Node.js；其他安装方式按客户端官方说明操作。

node -v
npm list -g --depth=0
# 按需安装，不必同时安装全部工具
npm install -g @openai/codex@latest
npm install -g @anthropic-ai/claude-code@latest
npm install -g @google/gemini-cli@latest

codex --version
claude --version
gemini --version

修改前备份现有配置文件，将需要的字段合并进去。环境变量只在当前终端设置时，通常需要在该终端启动工具才会生效。

API Key 分组选择

本站同时存在「标准（余额）」和「订阅（配额）」分组。先选计费方式，再选模型平台及分组。充值余额不会自动变成订阅额度，套餐额度也不能按余额分组的折扣倍率估算。

Claude Code

使用站点根地址与本站 Key。下列基础环境变量与本站公开的 Claude Code 使用模板一致。

export ANTHROPIC_BASE_URL="https://sub2api.vibelearning.top"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

$env:ANTHROPIC_BASE_URL="https://sub2api.vibelearning.top"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-key"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
claude

写入 settings.json

将以下 env 字段合并到 ~/.claude/settings.json；Windows 对应 %USERPROFILE%\.claude\settings.json。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://sub2api.vibelearning.top",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

模型选择以 Key 的可用模型为准。CLI 验证通过后再配置编辑器扩展；不要将主站 Key 或其他提供商的 Key 混入同一供应商配置。首次设置按当前客户端和站点说明完成。

Codex CLI

优先在本站 API Key 的使用说明中选择对应系统和认证方式，复制当前生成的配置。下面采用站点仍提供的 auth.json 认证方式作为基础示例；不包含站点专用图片扩展或模型目录文件。

配置文件

配置目录：macOS / Linux 为 ~/.codex，Windows 为 %USERPROFILE%\.codex。在现有 config.toml 中合并以下字段，模型名按实际权限替换。

model_provider = "vblcode"
model = "gpt-5.5"

[model_providers.vblcode]
name = "VBL-code"
base_url = "https://sub2api.vibelearning.top/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json：

{
  "OPENAI_API_KEY": "sk-your-key"
}

codex

CLI 能正常回复后，再启动使用同一配置的编辑器扩展。全局工作约定可写入 ~/.codex/AGENTS.md，但它不替代 API 地址与认证设置。

Gemini CLI

本站已配置公开标准分组 gemini-anti，基础倍率 0.3x。选择具备 Gemini 权限的 Key，模型 ID 从该分组的当前说明获取。

export GOOGLE_GEMINI_BASE_URL="https://sub2api.vibelearning.top"
export GEMINI_API_KEY="sk-your-key"
# 按分组实际支持的模型选择
export GEMINI_MODEL="your-enabled-gemini-model"
gemini

$env:GOOGLE_GEMINI_BASE_URL="https://sub2api.vibelearning.top"
$env:GEMINI_API_KEY="sk-your-key"
$env:GEMINI_MODEL="your-enabled-gemini-model"
gemini

若仍请求官方地址，检查用户目录和项目目录下 .gemini/.env 的覆盖设置，并重启终端。不要直接把原稿的 Gemini 分组名称带到本站。

Kimi Code

保留该客户端接入章节。当前公开站点信息没有确认 Kimi Code 的专用套餐或推荐安装方式；请按客户端官方说明安装，再确认其版本允许配置第三方提供商。

配置文件位置与字段随客户端版本变化，优先使用客户端当前文档。不要把 Codex / Claude 套餐名称当作兼容所有工具的承诺。

Grok Build

本站 Grok 使用模板采用 Responses。标准分组 grok 的基础倍率为 0.23x，另有 Grok 日卡、周卡。近期记录出现 grok-4.7；下方仍保留站点模板的 grok-4.5 示例，使用前按 Key 权限替换。

export GROK_MODELS_BASE_URL="https://sub2api.vibelearning.top/v1"
export XAI_API_KEY="sk-your-key"

将下列字段合并到客户端配置（原稿路径为 ~/.grok/config.toml，具体以所装版本为准）：

[endpoints]
models_base_url = "https://sub2api.vibelearning.top/v1"

[auth]
preferred_method = "api_key"

[model."grok-4.5"]
model = "grok-4.5"
name = "Grok via VBL-code"
env_key = "XAI_API_KEY"
api_backend = "responses"

env_key 填环境变量名称，不能填写真实 Key。模型 ID、搜索能力和其他高级字段，以本站 Key 使用模板及当前分组权限为准。

grok inspect

CC Switch

保留原稿的多客户端切换工作流。安装入口：CC Switch Releases。界面随版本调整，请按字段含义配置。

1. 新增自定义供应商名称建议填写 VBL-code，避免与 NewAPI 主站供应商混淆。
2. 选择目标应用分别为 Claude Code、Codex 或 Gemini 配置；一个应用的设置不等于全部应用已同步。
3. 填写地址和 Key地址使用本页 Base URL 表；Key 必须来自本站。
4. 保存并切换重启目标应用，发起一次最小请求，并在本站使用记录核对。

切换 Claude Code

切换 Codex CLI

Claude Desktop

桌面应用能否使用自定义网关，取决于所装客户端版本及 CC Switch 对该入口的支持。只有界面明确提供对应入口且分组允许时再配置，不能从 Claude Code 已连通推断桌面应用必然可用。

ChatGPT / Codex 桌面端

按实际产品区分设置。Codex CLI 的 Key 配置不等于 ChatGPT 桌面端获得登录权限。仅在目标应用明确提供自定义提供商或 API Key 模式时填写本站地址；如没有该入口，使用已支持的 CLI 或编辑器集成。

用量查询

本站用量优先查看 使用记录、我的订阅 或 Key Usage。不要直接套用 NewAPI 的 /api/usage/token/ 路径和用户 ID 模板。

CC Switch 若提供明确适配本站的用量模板，可按其当前说明配置；没有经过核对的用量接口时，保留控制台查询即可。

CC Switch CLI

命令行版本的安装和子命令以实际项目说明为准，不与桌面版混用。切换后检查目标工具的 Base URL、模型和认证来源，必要时重新打开终端。

Cherry Studio / Lobe Chat

先确认目标分组允许第三方客户端，并支持客户端实际发送的协议。支持 Responses 的分组不一定接受 Chat Completions。

WorkBuddy

如果所装版本提供自定义 API 接入，按客户端支持的协议填写本站地址与 Key。先用短文本测试，再启用工具调用、图片或长上下文；这些能力需要模型、网关和客户端同时支持。

OpenCode 与 Cline

按目标分组选择兼容提供商；OpenAI 兼容地址为下方示例。若客户端仅发送 Chat Completions，而分组要求 Responses，应选择支持 Responses 的提供商或调整客户端配置。

API Provider: 当前分组支持的提供商类型
Base URL:     https://sub2api.vibelearning.top/v1
API Key:      sk-your-key
Model ID:     your-enabled-model

API 路径

下表说明接入路径与前置条件。本次核对覆盖公开页面、已登录后台和使用说明，未使用账户 Key 发起付费调用；不能将模板存在写成生产调用已验证。

请求示例

先替换 Key 和模型 ID。以下为按协议组织的基础示例，字段与扩展能力以当前分组要求为准。

OpenAI Responses

curl https://sub2api.vibelearning.top/v1/responses \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-sol","input":"只回复 OK"}'

Anthropic Messages

curl https://sub2api.vibelearning.top/v1/messages \
  -H "x-api-key: sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-enabled-claude-model","max_tokens":64,"messages":[{"role":"user","content":"只回复 OK"}]}'

Chat Completions（分组支持时）

curl https://sub2api.vibelearning.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-enabled-model","messages":[{"role":"user","content":"只回复 OK"}]}'

Python SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["VBL_CODE_API_KEY"],
    base_url="https://sub2api.vibelearning.top/v1",
)
response = client.responses.create(
    model="gpt-6-sol",  # 替换为当前 Key 可用的模型
    input="只回复 OK",
)
print(response.output_text)

主站与订阅站

套餐、激活码与订阅

「充值/订阅 → 订阅」当前展示以下四类套餐。额度中的 $ 表示 API 消耗额度，售价中的 ¥ 表示购买金额，两者不要混用。以下是 2026-09-29 页面快照，最终以购买时的套餐卡片和确认金额为准。

价格示例

1. 开通或兑换从购买页选择系列、周期和额度；已有激活码则到「兑换」页面操作。
2. 确认权益在「我的订阅」核对生效状态、有效期及日 / 周 / 月额度限制。
3. 创建密钥并选择分组进入「API 密钥 → 创建密钥」，选择厂商和所购套餐对应的订阅分组。本次核对的表单没有独立的订阅卡片选择项。
4. 配置并查看用量用本站 Key 与地址配置客户端，在使用记录核对模型及消耗。

后台还保留其他订阅分组，但不能将其等同于当前在售套餐。续费、叠加、重置时刻、结转及到期处理以实际订单和订阅页面为准，本版不沿用旧稿未核验的规则。

故障排查

先核对域名、Key、分组与协议，再检查状态码。提交问题时提供请求时间、模型、接口路径、状态码、错误原文及日志 ID，不发送完整 Key。当前导航中的 /docs 在已登录状态下返回 404，可先使用本文、API 密钥页面的使用说明及本站支持入口。

HTTP 状态码

返回 HTML 而不是 JSON

确认没有把 /docs、/login 或控制台页面填进 Base URL。OpenAI 地址使用 https://sub2api.vibelearning.top/v1，不要重复拼接路径。

400 Bad Request

对照对应协议示例检查 JSON、Content-Type、模型参数与图片格式。不要将主站异步图片的 JSON 字段直接用于本站。

401 Unauthorized

检查完整 Key 是否来自本站、是否带空格或换行、是否已停用或过期。若 curl 正常而客户端失败，再检查客户端的认证来源和请求头。

403 / Usage not included

先检查订阅是否有效、分组是否正确、Key 限额和 IP 限制。错误也可能来自上游，需要结合错误原文和日志判断；不要将所有 403 都归因为号池偶发。

404 / 模型不存在

核对请求方法、路径和完整模型 ID。确认分组支持客户端实际发送的协议，特别是 Responses 与 Chat Completions 的区别。

429 Too Many Requests

降低并发并检查 5 小时 / 1 天 / 7 天等限制。若返回重置时间，等到对应时间后再试；不要持续重复请求。

超时 / 连接中断

检查本机网络、代理与长连接设置。图片请求超时时先查使用记录，再决定是否重试，避免重复生成或重复消费。

5xx 网关或上游失败

稍后少量重试；持续失败时保留请求时间、路径和日志 ID。对于会产生任务或消费的操作，先确认上一请求是否已完成。

模型或渠道不可用

登录模型广场核对当前模型，再检查 Key 的分组。文档中的示例模型和前端配置模板不等于所有账户实时可用。

CC Switch 问题

切换后仍走旧地址：检查当前应用入口、供应商选中状态及环境变量覆盖，重启目标应用。用量查询为空时，不要强行套用 NewAPI 查询模板，改从本站控制台核对。

Claude Code 问题

确认 ANTHROPIC_BASE_URL 为站点根地址，ANTHROPIC_AUTH_TOKEN 为本站 Key。检查用户与项目配置是否覆盖环境变量；CLI 与编辑器扩展可能使用不同设置来源。首次登录或初始化问题按当前工具提示及站点 Key 使用说明处理。

Codex 问题

401：检查 Authorization 与认证来源

如果使用本文的 auth.json 方式，供应商块应包含 requires_openai_auth = true，并确认 auth.json 内 Key 正确。若使用站点另一种 API Key 模板，则保持其完整认证字段，不要拼接两种方式。本版不把特定版本的错误行为概括为所有 Codex 版本的规则。

请求发往错误域名：检查 config.toml、环境变量及 CC Switch 当前供应商。Windows 路径或编码异常应先检查当前终端与文件编码，不把修改系统区域设置或网络 MTU 作为通用修复。

# 仅查看变量是否存在，不输出 Key
[ -n "$OPENAI_API_KEY" ] && echo "OPENAI_API_KEY is set"
[ -n "$OPENAI_BASE_URL" ] && echo "OPENAI_BASE_URL is set"

Gemini 问题

变量名使用 GOOGLE_GEMINI_BASE_URL，检查 .gemini/.env 是否覆盖配置。若模型无权限，先核对本站是否开放 Gemini 分组及对应权益，不能通过换客户端绕过套餐限制。

Grok Build 问题

检查 env_key 指向的变量是否已设置，并按本站模板保留 api_backend = "responses"。模型不存在时以当前分组列表为准；搜索、推理与其他扩展能力按模板和客户端版本逐项启用。

绘图问题

先确认图片模型与分组权限，再核对格式和尺寸。不使用原主站的 /api/image/jobs 作为本站默认路径；超时后先查看用量和任务结果，避免重复提交。图片与文本的计费规则分别查看当前页面。

注册与订阅问题

收不到验证码：核对邮箱域名是否在允许列表中，检查垃圾邮件并等待页面允许的重发时间。购买或兑换后仍无法调用：先确认权益到账与生效，再检查 Key 分组、有效期和各类限额。

社群与支持

请以本站登录后展示的官方支持入口和公告为准。「充值/订阅」页面显示微信扫码联系客服。原稿的微信群二维码、QQ 号码与赠送额度活动未重新核验，不作为本站当前承诺。