主题
new-api 平台说明
Shuro 基于开源网关 new-api 构建。这不只是技术细节——它决定了你能用什么客户端、控制台长什么样、以及很多行为可以直接按 new-api 的通用规则去理解。
对用户意味着什么
| new-api 提供的能力 | 你得到的 |
|---|---|
| 标准 OpenAI 协议 转发 | https://shuro.vip/v1 + /v1/chat/completions，任何 OpenAI 兼容客户端可接 |
| 标准 Anthropic 协议 转发 | https://shuro.vip + /v1/messages，Claude Code / Anthropic SDK 原生可接 |
| 令牌（API Key）管理 | 自助创建/禁用/限额多把 key，互相隔离 |
| 分组（group） | 不同分组不同倍率与模型可见性，见 Key 分组与权限 |
| 调用日志 | 每笔请求的模型、token 数、扣费明细可查 |
| 模型目录接口 | GET /v1/models 实时返回你这把 key 的可用模型 |
完整端点列表见 接口端点。
控制台功能速览
入口：https://shuro.vip/console。以下为 new-api 的通用界面描述。
令牌
创建和管理 API Key。每把 key 可单独设置：额度上限、过期时间、可用分组、模型范围。建议按用途分 key（如 Claude Code 一把、脚本一把），泄露时只作废一把。
日志
逐笔调用明细：时间、模型、输入/输出 token、倍率、扣费额度。这是核对账单的第一入口，用法见 计费与倍率。
价格
各模型的模型倍率、分组倍率与实时单价。文档里的倍率表可能滞后，以这里为准。
对开发者：任何支持自定义 base_url 的客户端都能接
new-api 的转发是协议级兼容的——不需要专门的"Shuro SDK"。只要客户端/SDK 允许改 base URL：
text
OpenAI 协议 base_url = https://shuro.vip/v1
Anthropic 协议 base_url = https://shuro.vip- 官方 SDK 接入示例：OpenAI SDK、Anthropic SDK
- CLI / GUI 客户端选型：选择客户端
- Claude 系列支持双协议任选；GPT 系列仅 OpenAI 协议，见 支持的模型
用 /v1/models 查可用模型
new-api 的标准能力：GET /v1/models 返回当前这把 key 实际有权限的模型列表（随分组不同而不同）：
bash
curl -sS 'https://shuro.vip/v1/models' \
-H 'Authorization: Bearer <您的 API Key>' \
| jq -r '.data[].id' | sort返回格式为 OpenAI 标准的模型列表：
json
{
"object": "list",
"data": [
{ "id": "claude-opus-4-8", "object": "model", ... },
{ "id": "claude-fable-5", "object": "model", ... }
]
}排查第一步
"模型调不通"类问题，先跑这条命令确认模型 ID 在不在你的 key 的列表里，再看 错误代码对照表。
与 one-api / new-api 生态的兼容性
new-api 是 one-api 的社区延续版，二者 API 层高度兼容。围绕这套接口形成了一个生态：
- 按 OpenAI 协议写的工具（对话 GUI、翻译插件、浏览器扩展等）：填
https://shuro.vip/v1+ key 即可用，见 通用对话 GUI - 多 Provider 切换工具（如 CC Switch）：把 Shuro 当作一个标准 provider 条目管理
- 面向 one-api/new-api 的额度查询、日志分析类工具：协议上通常兼容，但第三方工具质量参差，接入前自行验证，Shuro 不为其行为背书
不要依赖非标准接口
生态工具有时会调用 new-api 的内部管理接口（/api/...）。这些不是公开承诺的稳定 API，可能随版本变化。生产集成请只依赖标准的 /v1/* 端点，见 接口端点。