功能指南概述
New API 功能指南,按用户指南、管理员指南和系统设置指南组织。
New API 是一个统一的 AI 模型接口管理与分发系统,支持将多种大模型转为统一格式调用,支持 OpenAI、Claude 等格式,可供个人或者企业内部管理与分发渠道使用,并提供游乐场、OpenAI 兼容接口、模型与渠道路由、用量日志、计费、订阅和系统运维等能力。
- 本指南按角色和功能分区分为用户指南、管理员指南和系统设置指南三部分。
系统首页
站点首页是打开站点时看到的第一个页面,可从顶部导航或页面中的按钮进入控制台、模型广场、排行榜和文档等页面。
- 功能指南概述-系统首页

超级管理员(Root)可在「系统设置」→「站点与品牌」→「系统信息」的「首页内容」中填写网址、HTML 或 Markdown,替换首页显示的内容;清空该字段后恢复内置首页。「站点与品牌配置」→
- 功能指南概述-首页内容设置

角色说明
平台根据账号角色控制菜单访问和操作权限,共分为三种角色:
-
普通用户
注册后的默认角色,可使用平台开放的个人功能,例如游乐场、聊天、概览、数据看板、API 密钥、使用日志、审计日志、任务日志、钱包、个人资料和安全与访问等。
顶部导航、侧边栏模块和签到等入口由超级管理员(Root)配置控制。「站点与品牌配置」→ -
管理员(Admin)
在普通用户权限基础上,Admin 默认可访问渠道、模型、用户、兑换码和订阅等管理资源。
渠道等资源还区分读取、操作、普通写入、敏感写入和查看密钥等动作,超级管理员(Root)可在用户管理中为管理员(Admin)账号设置「管理员权限」,覆盖默认权限。「管理员权限」→ -
超级管理员(Root)
Root 拥有全部权限,额外可访问系统信息、插件、请求处理和系统设置,并可修改模型价格。
系统设置分为站点与品牌、身份验证、计费与支付、模型、请求策略、安全与限制、控制台内容、运维八个设置域。「系统设置概览」→
用户指南
适用于普通用户、Admin 和 Root,覆盖从注册登录、创建 API 密钥、调用模型,到查看日志和管理个人账户的常用流程。第一次使用时,请先阅读快速上手。
快速上手
按 6 个步骤完成从注册登录到第一次调用模型,并认识控制台的顶部栏和侧边栏。
- 几个基本概念
- 完成第一次调用
- 认识控制台界面
注册与登录
注册账户,使用账号密码、第三方账号或 Passkey 登录并完成登录验证,忘记密码时通过邮箱重置。
- 使用账号密码登录
- 使用第三方账号或 Passkey 登录
- 完成登录验证
- 注册账户
- 重置忘记的密码
- 查看和退出登录会话
游乐场
在网页中选择分组和模型、调整参数并与模型对话,测试模型效果;并提供用 API 调用模型的地址、认证方式、SDK 示例和支持的接口端点。
- 发送消息并查看回复
- 调整请求参数
- 管理对话
- API 地址与认证
- SDK 示例
- 支持的接口端点
聊天
将 New API 的配置快速导入到各类 AI 聊天应用中,方便测试和日常使用。
- 聊天预设一键导入配置
- API 密钥一键导入配置
- 手动配置聊天应用
概览
查看账户的额度、用量和请求次数,按设置引导和示例命令完成首次调用,并查看管理员发布的公告、API 信息、常见问答和运行状态。
- 按设置引导开始使用
- 复制示例命令发送第一个请求
- 查看额度和用量
- 查看公告、API 信息、常见问答和运行时间
数据看板
按时间范围查看模型调用次数、Token 和额度消耗,查看调用在 API 密钥、分组和模型之间的分流,并设置图表的默认显示。
- 筛选数据
- 设置图表的默认显示
- 查看模型调用分析
- 查看分流
- 查看用户统计(仅管理员可见)
API 密钥
创建、复制和管理调用模型用的 API 密钥,可限制额度、过期时间、可用模型和 IP,并能一键导入 CC Switch 等客户端。
- 创建 API 密钥
- 复制密钥并调用模型
- 导入到 CC Switch 或聊天应用
- 编辑、禁用或删除密钥
使用日志
查看每次调用模型的用量和扣费,以及充值、退款等额度变动记录,可按条件筛选和导出,并在详情中核对计费明细。
- 筛选日志并查看统计
- 查看日志详情
- 导出日志
审计日志
查看账户的登录、安全设置、API 密钥和访问令牌等操作记录,核对每次操作的时间、来源和结果。
- 筛选审计日志
- 查看审计详情
- 事件分类
任务日志
查看视频、音乐等异步任务和 Midjourney 绘图任务的状态、进度、生成结果和失败原因,了解超时和退款规则。
- 筛选任务
- 查看任务详情和制品
- 查看绘图日志
- 查看提示词、图片和失败原因
- 查看失败任务的退款
钱包
查看余额和用量,在线充值或兑换额度,购买订阅套餐并选择计费偏好,转移邀请奖励,查看订单历史。付款方式、充值金额、订阅套餐和邀请奖励均由管理员配置。
- 在线充值
- 兑换码
- 查看订单历史
- 订阅计划
- 选择计费偏好
- 转移邀请奖励
个人资料
查看账户信息和用量,设置通知方式和偏好、界面语言、左侧边栏显示的页面,并每日签到领取额度。
- 设置通知和行为偏好
- 设置界面语言
- 每日签到领取额度
- 设置左侧边栏显示的页面
安全与访问
修改密码、绑定邮箱和第三方账号,启用两步验证和 Passkey,管理登录会话和访问令牌,设置是否记录 IP 地址,或删除账户。
- 完成安全验证
- 更改或设置密码
- 绑定邮箱和第三方账号
- 启用或禁用两步验证、重新生成备用码
- 启用或解绑 Passkey
- 管理登录会话
- 创建和管理访问令牌、查看访问记录
- 设置是否记录 IP 地址
- 删除账户
模型广场与排行榜
查看本站可用的模型和价格,查看模型的性能和调用示例,以及按用量统计的模型和厂商排行。
- 查找和筛选模型
- 切换视图和价格显示
- 读懂模型价格
- 查看模型详情
- 查看排行榜
常见问题
按提示原文或现象查找调用失败、额度与费用、账号与登录、界面与显示等跨页面问题的原因和处理方法。
- 调用失败
- 额度与费用
- 账号与登录
- 界面与显示
管理员指南
适用于 Admin 和 Root,包含九个日常管理页面,其中计费表达式、系统信息、插件管理和请求处理为 Root 专属。系统级选项另归入后面的系统设置指南。
计费表达式(Root 专属)
在定价编辑器中用计费表达式为模型定价,定义 Token 单价、阶梯条件、按次价格和请求规则,并用费用估算和请求模拟验证;了解预扣、结算和保存校验规则。
渠道管理
配置 AI 服务商、插件、网关和自定义渠道,维护凭证、模型、分组、路由映射和优先级,使用多 Key 和参数覆盖,并执行测试、余额查询、上游模型更新和批量操作。
模型管理
维护模型资料、名称匹配、模型广场展示、供应商和预填充分组,并从上游同步模型资料;Root 还可修改模型定价并同步价格。部署服务已配置时,也可管理 io.net 模型部署。
用户管理
查看和维护用户账户、状态、角色、分组、额度、登录绑定、订阅、Passkey 与 2FA;Root 可为 Admin 账号设置「管理员权限」。
兑换码管理
创建、查看、编辑、启用、禁用和删除额度兑换码,支持批量复制、批量删除和删除无效兑换码;创建时可将兑换码保存为 TXT 或 Markdown 文件。
订阅管理
创建和维护订阅套餐,配置有效期、额度重置周期、分组升级与回退和支付方式,启用或禁用套餐,并批量重置订阅额度。
系统信息(Root 专属)
查看实例节点状态、资源指标、各节点的同步状态和后台系统任务,并清理失联实例记录和历史系统任务。
插件管理(Root 专属)
管理任务、渠道和请求处理三类插件:浏览官方与社区插件市场、上传本地插件、查看插件详情与沙盒,并控制插件启用状态和插件渠道绑定。
请求处理(Root 专属)
在请求发往上游前检查或修改请求:添加请求处理实例,设置适用范围、模型与运行顺序,用示例请求试运行,并在渠道中添加实例。
分组是渠道、用户、API 密钥和计费配置共同使用的路由与计费维度,不再作为独立主导航项。调用和扣费记录请参阅使用日志,绘图记录和用户异步任务请参阅任务日志。
系统设置指南
系统设置是 Root 专属的实例级配置工作区。配置按职责拆为八个设置域,并由一页概览说明通用的保存、生效和验证边界。
系统设置概览
了解系统设置的入口与权限、八个设置域、保存与生效机制、多实例同步、敏感配置与审计记录,以及变更验证要求。
站点与品牌配置
配置站点身份、公开内容与法律文档、系统公告、顶部导航和侧边栏模块。
身份验证配置
配置注册、登录、OAuth、Passkey、机器人保护及自定义 OAuth 身份提供方。
计费与支付配置
配置额度与货币显示、模型与分组价格、支付网关和签到奖励。
模型配置
配置全局模型行为、供应商协议适配和 io.net 模型部署服务。
请求策略配置
配置会话保持与重试、渠道健康检查与自动禁用,并了解请求决策记录。
安全与限制配置
配置模型请求速率限制、SSRF 防护和 API 密钥数量限制。
控制台内容配置
配置数据仪表板、公告、API 地址、常见问答、Uptime Kuma、聊天预设和绘图。
运维配置
配置运行模式、模型性能指标、邮件与额度提醒、Worker 代理、日志维护、性能保护和版本检查。
这篇文档对您有帮助吗?
最后更新于