New APINew API
使用指南部署安装API 参考AI 应用Skills插件帮助支持商务合作合规与使用政策
⚠️合规提示:本项目仅用于合法授权的 API 网关、内部管理和私有化部署场景。请遵守上游服务条款、平台规则、监管要求和内容安全要求。

功能指南概述

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 代理、日志维护、性能保护和版本检查。

查看详细文档 →

这篇文档对您有帮助吗?

最后更新于