New API 使用手册
New API 是一套开源的统一 AI 网关。本站点（ai.moespark.dev）把多家模型供应商聚合到一套兼容 OpenAI / Claude / Gemini 的接口后面，统一做密钥、额度、计费、渠道与流量管理。你只需要一个 Base URL 和一个令牌，就能调用几十种模型。
提示
本手册面向两类读者：调用方（用户/开发者）看「开始 / 使用 / 参考」即可快速接入；管理员看「管理」章节了解渠道、用户与计费配置。
为什么用它
- 一个入口，多种模型：不用为每家供应商维护一套 SDK 和密钥；改一个
model字段即可切换模型。 - 协议兼容：既有 OpenAI 兼容接口，也保留 Claude（
/v1/messages）与 Gemini 原生协议，老代码几乎零改动。 - 令牌与配额：为每个应用签发独立令牌，设置额度、有效期、可用模型、IP 白名单，互不影响。
- 多渠道与容灾：同名模型可绑定多个上游渠道，按权重分流、失败切换。
- 用量与账单：按 token 统计消耗与费用，可查日志、导出账单。
工作原理
你的程序 / SDK
│ ① 携带令牌请求 /v1/chat/completions
▼
┌──────────────────────────────┐
│ New API 网关 (ai.moespark) │
│ 认证 → 选渠道 → 转换协议 → 计费 │
└──────────────────────────────┘
│ ② 网关用对应渠道的密钥向上游请求
▼
OpenAI / Anthropic / Gemini / Azure / 第三方中转 …
│ ③ 上游返回，网关记账并回传
▼
你的程序对使用者而言，网关就是"一个 OpenAI 兼容的服务"；对管理员而言，它是一张可编排的"渠道—模型—令牌—用户"关系网。
关键概念速查
| 名词 | 含义 |
|---|---|
| Base URL | AI 接口根地址：https://ai.moespark.dev；OpenAI 兼容前缀为 /v1 |
| 令牌 / API Key | 控制台创建的密钥，形如 sk-xxxxxxxx，用于请求鉴权 |
| 渠道 Channel | 管理员配置的一条上游供应商连接（类型、Base URL、密钥、模型列表） |
| 分组 Group | 令牌归属的分组，决定可见模型与费率（由管理员配置） |
| 额度 Quota | 令牌或用户可消耗的总量，可按次数或按费用计 |
| 模型 Model | 请求里的 model 字段，对应上游真实模型名 |
从哪里开始
| 我想… | 看这篇 |
|---|---|
| 5 分钟跑通第一次调用 | 快速开始 |
| 搞清楚 API Key / 令牌怎么配、额度怎么设 | 认证与令牌 |
| 知道有哪些模型、怎么计费 | 模型与定价 |
| 查看每个接口的请求/响应字段 | API 参考 |
| 用 Python / Node / Go / Java 接入 | 多语言 SDK 示例 |
| 做函数调用、结构化输出、多模态 | 高级用法 |
| 报错看不懂 | 错误码与限流 |