Stanvast AI Gateway

AI Gateway 大模型统一聚合网关，全兼容OpenAI标准接口，一站式调用GPT / Claude / GLM系列模型

Base URL：https://ai.stanvast.com/v1

一、平台概述

本项目基于开源 NewAPI 搭建Token中转聚合服务，统一封装多厂商大模型接口，对外输出标准OpenAI兼容API，解决多模型密钥分散、客户端切换繁琐、国内访问不稳定问题。

核心能力

  • 多模型聚合：单API Key访问GPT、Claude、GLM全系列模型，无需单独对接各厂商
  • OpenAI全兼容：请求/响应格式、流式SSE完全对齐OpenAI官方，现有SDK零修改迁移
  • 子令牌分发管控：后台生成独立子Token，限制额度、可用模型、IP白名单，保护上游原始密钥
  • 负载均衡&故障切换：多上游渠道自动分流，渠道异常自动切换备用源
  • 用量统计看板：实时Token消耗、调用次数、调用成功率可视化统计
  • Claude格式适配：原生支持Claude Messages接口，搭配CC-Switch实现第三方模型互通
备注：CC-Switch新版本存在已知BUG，生产使用建议锁定稳定旧版本。

二、基础API信息

配置项 参数值
服务域名(BaseURL) https://ai.stanvast.com/v1
传输协议 HTTPS
数据编码 UTF-8 / JSON
认证方式 Authorization: Bearer {你的中转Token}
流式输出 支持SSE Server-Sent Events
兼容标准 OpenAI v1 完整规范、原生Claude接口适配

核心接口端点

  • POST /chat/completions 对话补全（主流调用）
  • GET /models 获取全部可用模型列表
  • GET /dashboard/billing/usage 查询Token消耗额度
  • POST /claude/messages Claude原生消息接口

三、支持模型列表

Claude系列

anthropic.claude-haiku-4-5-20251001 anthropic.claude-sonnet-4-6 claude-opus-4-7

ChatGPT系列

gpt-5.4 gpt-5.5

GLM系列

glm-5 glm-5.1-apipro

完整模型清单可调用 GET https://ai.stanvast.com/v1/models 获取JSON列表

四、快速调用示例

1. cURL 基础调用

curl --request POST \
  --url https://ai.stanvast.com/v1/chat/completions \
  --header "Authorization: Bearer sk-你的中转令牌" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gpt-5.5",
    "temperature": 0.7,
    "max_tokens": 1024,
    "messages": [
      {"role":"user","content":"你好，介绍一下Stanvast中转站"}
    ]
  }'

2. Python OpenAI SDK

from openai import OpenAI

# 初始化客户端
client = OpenAI(
    base_url="https://ai.stanvast.com/v1",
    api_key="sk-你的中转令牌"
)

# 调用Claude Sonnet示例
resp = client.chat.completions.create(
    model="anthropic.claude-sonnet-4-6",
    messages=[{"role":"user","content":"请写一段产品说明文档"}]
)
print(resp.choices[0].message.content)

3. Node.js Fetch

async function chat() {
  const res = await fetch("https://ai.stanvast.com/v1/chat/completions", {
    method: "POST",
    headers: {
      "Content-Type":"application/json",
      "Authorization":"Bearer sk-你的中转令牌"
    },
    body: JSON.stringify({
      model: "glm-5.1-apipro",
      messages: [{role:"user", content:"写一段代码示例"}]
    })
  })
  const data = await res.json();
  console.log(data.choices[0].message.content);
}
chat();

五、客户端接入完整配置教程

前置说明：所有客户端请先在后台生成中转Token，替换文档内 sk-你的中转令牌。
区分规则：OpenAI兼容协议（Codex/Cursor/OpenCode/Windsurf）地址带 /v1；原生Claude Code协议不带 /v1。

🔹 OpenAI Codex（CLI / VSCode插件）

Codex 使用 OpenAI 协议，BaseURL 必须带 /v1

方式1：环境变量（临时生效，推荐测试）
# macOS / Linux
export OPENAI_BASE_URL="https://ai.stanvast.com/v1"
export OPENAI_API_KEY="sk-你的中转令牌"
codex

# Windows PowerShell
$env:OPENAI_BASE_URL="https://ai.stanvast.com/v1"
$env:OPENAI_API_KEY="sk-你的中转令牌"
codex
方式2：配置文件永久生效 config.toml

路径：~/.codex/config.toml（macOS/Linux）、C:\Users\用户名\.codex\config.toml

model_provider = "stanvast"
model = "gpt-5.5"

[model_providers.stanvast]
name = "Stanvast中转站"
base_url = "https://ai.stanvast.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json 写入密钥（同目录）

{"OPENAI_API_KEY":"sk-你的中转令牌"}

🔹 Claude Code（Anthropic 原生协议）

⚠️ 重点坑点：Claude Code原生协议 BaseURL 不带 /v1！ 地址填写：https://ai.stanvast.com，不要追加 /v1；依靠NewAPI内置 /claude/messages 路由兼容。
方式1：环境变量启动
# macOS / Linux
export ANTHROPIC_BASE_URL="https://ai.stanvast.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的中转令牌"
export ANTHROPIC_MODEL="anthropic.claude-sonnet-4-6"
claude

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://ai.stanvast.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的中转令牌"
$env:ANTHROPIC_MODEL="anthropic.claude-sonnet-4-6"
claude
方式2：settings.json 持久配置

路径：~/.claude/settings.json

{
    "autoUpdatesChannel": "latest",
    "env": {
        "ANTHROPIC_BASE_URL": "https://ai.stanvast.com",
        "ANTHROPIC_AUTH_TOKEN": "sk-你的中转令牌",
        "ANTHROPIC_MODEL": "anthropic.claude-sonnet-4-6",
        "API_TIMEOUT_MS": "300000"
    }
}

修改完成后，完全退出Claude Code进程再重启生效。

🔹 OpenCode 多模型终端

OpenCode支持自定义OpenAI兼容服务商，直接对接中转地址。

配置文件路径：~/.config/opencode/opencode.json

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "stanvast": {
            "npm": "@ai-sdk/openai-compatible",
            "name": "Stanvast中转",
            "options": {
                "baseURL": "https://ai.stanvast.com/v1",
                "apiKey": "sk-你的中转令牌"
            }
        }
    }
}

保存后启动OpenCode，模型供应商选择 Stanvast中转，即可自由切换GPT/Claude/GLM模型ID。

🔹 Cursor AI 编辑器（OpenAI兼容）

BaseURL：https://ai.stanvast.com/v1，必须携带 /v1
方式1：图形界面可视化配置（推荐新手）
  1. 打开 Cursor → 快捷键 Ctrl+, / Cmd+, 进入设置
  2. 左侧切换到 Models 页面
  3. 找到 OpenAI API Key，填入 sk-你的中转令牌
  4. 开启 Override OpenAI Base URL (when using key)
  5. 填入地址：https://ai.stanvast.com/v1
  6. 点击 Verify 验证，完全重启 Cursor
  7. 在模型列表手动添加可用模型ID：gpt-5.5、anthropic.claude-sonnet-4-6、glm-5
方式2：settings.json 配置文件

快捷键 Ctrl+Shift+P / Cmd+Shift+P → Open User Settings (JSON)

{
    "ai.openai.apiKey": "sk-你的中转令牌",
    "ai.openai.baseUrl": "https://ai.stanvast.com/v1",
    "ai.model": "gpt-5.5",
    "ai.temperature": 0.7
}
⚠️ 常见问题：Cursor部分版本会拦截名称包含 claude 的模型；无法调用时建议在NewAPI后台配置模型别名。

🔹 Windsurf（原Codeium）编辑器 Cascade

BaseURL：https://ai.stanvast.com/v1

Windsurf支持自定义OpenAI兼容模型，用于Cascade对话与代码编辑。

方式1：图形界面配置
  1. 打开 Windsurf → Ctrl+, / Cmd+, 进入设置
  2. 搜索 AI / Model Provider
  3. 选择 OpenAI Compatible
  4. Base URL：https://ai.stanvast.com/v1
  5. API Key：sk-你的中转令牌
  6. 默认模型填写支持的Model ID，保存重启编辑器
方式2：settings.json 配置
{
    "ai.provider": "openai-compatible",
    "ai.baseUrl": "https://ai.stanvast.com/v1",
    "ai.apiKey": "sk-你的中转令牌",
    "ai.defaultModel": "gpt-5.5"
}
⚠️ 注意：Windsurf代码自动补全（inline autocomplete）默认仍然使用Codeium官方模型；仅Cascade对话使用自定义API。

🔹 通用网页客户端（LobeChat / NextChat）

  • 自定义API代理地址：https://ai.stanvast.com/v1
  • 密钥填写后台下发中转Token
  • 模型列表自动拉取，直接选择文档内Model ID

六、CC-Switch 模型转换工具

当Claude Code需要接入第三方GLM/GPT模型时，使用CC-Switch做接口格式互转，兼容原生Claude客户端协议。

重要提示：CC-Switch新版本存在持续性BUG，生产环境建议锁定历史稳定版本，测试环境可自行调试。

工具用途

  • 将OpenAI格式请求自动转换为Claude Messages格式
  • Claude客户端透明调用GPT、GLM系列模型
  • 统一处理Token计数、上下文长度兼容适配

七、常见错误排查指南

错误现象 排查方案
401 Unauthorized Token填写错误/已过期/额度耗尽，后台重新生成子令牌
404 Not Found 区分协议：Codex/Cursor/OpenCode/Windsurf带/v1；Claude Code原生协议不能带/v1
400 Model not exists Model ID拼写错误，调用/v1/models核对完整模型名
流式输出中断/无返回 超时参数调至300000ms，检查HTTPS连通性，切换渠道
Claude Code 持续报错 确认BaseURL不带/v1；优先使用settings.json配置，重启客户端
Cursor无法调用Claude模型 Cursor客户端拦截claude前缀模型，NewAPI后台配置模型别名解决
Windsurf修改配置后不生效 完全退出Windsurf进程（托盘彻底关闭）再重启，Cascade才会加载新API

八、NewAPI 中转站部署说明（自建参考）

本平台基于开源NewAPI单镜像部署，使用SQLite内置数据库，开箱即用。

# Docker一键部署命令
docker run --name stanvast-newapi -d --restart always \
-p 3000:3000 \
-e TZ=Asia/Shanghai \
-v ./stanvast-data:/data \
calciumion/new-api:latest

后台管理访问

管理面板地址：https://ai.stanvast.com，登录后可完成：渠道密钥添加、子Token生成、用量看板、模型访问权限管控、负载均衡配置。