功能指南概述
AIMirrorX 功能指南，按用户指南、管理员指南和系统设置指南组织。
AIMirrorX 是一个统一的AI模型接口管理与分发系统，支持将多种大模型转为统一格式调用，支持OpenAI、Claude等格式，可供个人或者企业内部管理与分发渠道使用，并提供游乐场、OpenAI 兼容接口、模型与渠道路由、用量日志、计费、订阅和系统运维等能力。
- 本指南按角色和功能分区分为用户指南、管理员指南和系统设置指南三部分。
系统首页
角色说明
平台根据账号角色控制菜单访问和操作权限，共分为三种角色：
-
普通用户
注册后的默认角色，可使用平台开放的个人功能，例如游乐场、聊天预设、概览、数据看板、API 密钥、日志、钱包和个人资料等。
顶部导航、侧边栏模块和签到等入口由 超级管理员（Root）配置控制。「站点与品牌配置」→ -
管理员（Admin）
在普通用户权限基础上，Admin 默认可访问渠道、模型、用户、兑换码和订阅等管理资源。
渠道等资源还区分读取、操作、普通写入、敏感写入和查看密钥等动作，超级管理员（Root）可为管理员（Admin）账号设置权限覆盖以管理可用权限。「站点与品牌配置」→ -
超级管理员（Root）
Root 拥有全部权限，额外可访问系统信息/system-info、任务插件/task-plugins和系统设置/system-settings/site。
系统设置分为站点与品牌、身份验证、计费与支付、模型与路由、安全与限制、控制台内容、运维七个设置域。
用户指南
适用于普通用户、Admin 和 Root，覆盖从注册、创建 API 密钥、调用模型、查看日志和管理个人账户等常用流程。
注册与登录
了解注册、账号密码登录、忘记密码重置、Passkey、第三方 OAuth 和登录会话管理。
- 账号密码登录
- Passkey 和第三方 OAuth 登录
- 注册流程
- 登录会话管理
- 忘记密码重置
概览与数据看板
概览页提供快速开始向导、API 请求示例、余额与用量摘要、性能健康、公告、FAQ 和运行状态等模块信息。
数据看板提供模型调用分析、分流和用户分析（仅admin和root）。
- 快速开始向导
- 用量与健康状态
- API 信息、公告、FAQ 和运行时间
- 模型调用分析
- 分流
- 用户统计
个人资料与安全
查看或管理账号信息、绑定信息、通知和行为偏好、安全设置、2FA管理、Passkey管理、登录会话管理等个人设置。
- 查看账户信息
- 管理账号绑定信息
- 设置通知和行为偏好
- 设置界面语言偏好
- 个人左侧边栏设置个性化显示
- 每日签到
- 安全设置
- 启用或禁用两步认证（2FA）
- 启用或禁用 Passkey 无密码登录
- 登录会话管理
API 密钥
管理API 密钥，API 密钥是调用网关 API 的凭证，可单独配置额度、过期时间、模型限制、分组、Auto 分组顺序、跨分组重试和 IP 白名单等参数。
- 创建 API 密钥
- 查看和复制 API 密钥
- 编辑 API 密钥
- 启用、禁用和删除API 密钥
使用 API 与游乐场
使用游乐场在线测试和体验 AI 模型；或使用 API 密钥 OpenAI 兼容接口调用 Claude、Gemini、Responses、图像、音频等端点。
- 游乐场
- API 地址与认证
- SDK 示例
- 支持的接口端点
聊天应用集成
AIMirrorX 支持快速导入配置到多种 AI 聊天应用，方便测试和日常使用。
- AIMirrorX 的聊天集成有三种方式：
- 聊天预设一键导入配置
- API密钥一键导入配置
- 手动配置聊天应用
日志与异步任务
查看使用日志、绘图日志和异步任务日志，筛选查看请求、模型、状态、Token、耗时、错误、结果和计费等日志信息。
- 使用日志
- 绘图日志
- 异步任务日志
- 任务状态与后台处理
- 接口参考：日志查询接口、异步生成与任务接口
钱包与订阅
查看和管理钱包余额、在线充值余额、兑换码兑换余额、查看历史订单、订阅套餐、查看和领取邀请奖励、选择计费偏好。支付方式、金额、折扣、奖励、套餐和计费规则均由平台管理员配置。
- 查看余额与用量
- 在线充值
- 兑换码
- 订阅计划
- 购买订阅套餐
- 查看订阅状态
- 选择计费偏好
- 邀请奖励
- 订单历史
- 常见限制
模型广场和排行榜
浏览平台已启用的 AI 模型的定价信息和状态；查看平台模型及供应商的使用量排名与变化趋势。
- 模型广场
- 排行榜
管理员指南
适用于 Admin 和 Root，包含七个日常管理页面。系统级选项另归入后面的系统设置指南；其中系统信息和任务插件为 Root 专属。
渠道管理
配置上游 AI 服务商渠道、认证信息、模型、分组和路由可靠性策略，并执行测试、余额刷新、模型同步和批量操作。
模型管理
维护模型元信息、名称匹配、供应商和官方同步；在部署服务已由 Root 配置时，也可管理托管模型部署。
用户管理
查看和维护用户账户、状态、角色、分组、额度、登录绑定、安全凭证和订阅。
兑换码管理
创建、查看、编辑、启用、禁用和清理额度兑换码。
订阅管理
发布和维护订阅套餐，管理用户订阅权益、额度周期、分组升级与回退。
系统信息（Root 专属）
查看实例节点状态、资源指标和后台系统任务，并处理失联实例记录。
任务插件管理（Root 专属）
管理异步任务插件：浏览任务插件市场、上传本地插件、查看插件详情与沙箱能力，并控制插件全局启用状态和任务插件渠道绑定。
分组是渠道、用户、API 密钥和计费配置共同使用的路由与计费维度，不再作为独立主导航项。日志、绘图记录和用户异步任务的查看方式请参阅日志与异步任务。
系统设置指南
系统设置是 Root 专属的实例级配置工作区。配置按职责拆为七个设置域，并由一页概览说明通用的保存、生效和验证边界。
系统设置概览
了解系统设置的入口、七个设置域、保存机制、多实例同步、敏感配置和变更验证要求。
站点与品牌配置
配置系统信息、公开内容、法律文档、公告、顶部导航和侧边栏模块。
身份验证配置
配置注册、登录、OAuth、Passkey、机器人防护及自定义 OAuth 身份提供方。
计费与支付配置
配置额度单位、货币、模型与分组价格、支付网关、充值和签到奖励。
模型与路由配置
配置全局模型行为、路由可靠性、协议适配、渠道亲和和模型部署服务。
安全与限制配置
配置速率限制、敏感词、SSRF 防护和 API 密钥数量限制。
控制台内容配置
配置数据看板、结构化公告、API 信息、FAQ、Uptime Kuma、聊天预设和绘图相关内容。
运维配置
配置系统行为、监控告警、SMTP、Worker、日志维护、性能和更新检查。