说明：
当前的想采用
┌─────────────────────────────────────────────────────────────────┐
│ 客户端 (Client) │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 营销页面 │ │ 主界面 │ │ 文档中心 │ │
│ │ (落地页) │ │(核心功能)│ │(对接指南)│ │
│ └──────────┘ └──────────┘ └──────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 管理端 (Admin) │
│ ┌──────────┐ ┌──────────┐ │
│ │ API Key │ │ 用量监控 │ │
│ │ 管理 │ │ │ │ │
│ └──────────┘ └──────────┘ │
└─────────────────────────────────────────────────────────────────┘
面向潜在用户，展示产品价值促成转化。
| 编号 |
页面 |
路由 |
功能说明 |
| C-P01 |
落地页 |
/ |
产品介绍、核心优势、模型展示 |
| C-P02 |
定价页 |
/pricing |
套餐对比（Lite/Pro）、价格展示 |
| C-P03 |
文档首页 |
/docs |
API 文档入口、快速开始 |
| C-P04 |
对接指南 |
/docs/integrations |
第三方工具配置教程 |
| 模块 |
说明 |
| Hero 区域 |
主标题、副标题、CTA 按钮 |
| 模型展示 |
首批支持模型卡片（Kimi2.5、Qwen3.5、GLM5） |
| 工具集成 |
支持的工具图标（Cursor、Claude Code、VSCode 等） |
| 价格预览 |
Lite/Pro 套餐简要对比 |
| 页脚 |
链接导航 |
用户登录后的主要操作区域，平台核心功能。
| 编号 |
页面 |
功能说明 |
| C-P05 |
产品首页 |
用量概览、快捷入口 |
| C-P06 |
API Key 管理 |
创建、查看、管理 API Key |
| C-P07 |
套餐订阅 |
套餐展示、购买、续费 |
| C-P08 |
订阅管理 |
当前套餐详情、升级/降级 |
| C-P09 |
加油包 |
购买额外额度 |
| C-P10 |
用量统计 |
调用明细、额度消耗 |
| C-P11 |
账单记录 |
订单列表、发票申请 |
| 模块 |
编号 |
功能 |
说明 |
| API Key |
C-F01 |
生成 API Key |
创建新的调用密钥 |
|
C-F02 |
查看 Key 列表 |
所有 Key 及状态 |
|
C-F03 |
禁用/启用 Key |
临时开关 Key |
|
C-F04 |
删除 Key |
永久移除 Key |
|
C-F05 |
复制 Key |
一键复制 API Key |
| 套餐 |
C-F06 |
套餐展示 |
Lite/Pro 套餐对比 |
|
C-F07 |
套餐订阅 |
选择套餐并支付 |
|
C-F08 |
续费管理 |
续费当前套餐 |
|
C-F09 |
升级/降级 |
切换套餐（差价结算） |
|
C-F10 |
加油包购买 |
购买额外额度包？ |
| 用量 |
C-F11 |
额度查询 |
剩余额度、有效期 |
|
C-F12 |
用量明细 |
按天/按模型统计 |
|
C-F13 |
调用日志 |
近期 API 调用记录 |
| 账单 |
C-F14 |
订单列表 |
历史订单及状态 |
|
C-F15 |
订单详情 |
单笔订单信息 |
帮助用户快速接入和使用。
| 编号 |
页面 |
功能说明 |
| C-P12 |
API 文档 |
OpenAI/Anthropic 兼容接口文档 |
| C-P13 |
SDK 指南 |
Python/Node.js 等 SDK 使用 |
| C-P14 |
工具对接 |
Cursor、Claude Code 等配置教程 |
| C-P15 |
常见问题 |
FAQ 汇总 |
| C-P16 |
错误码 |
错误码及解决方案 |
| 编号 |
页面 |
功能说明 |
| A-P01 |
列表 |
列表首页 |
| A-P02 |
API Key 审计 |
查看所有 Key，强制禁用 |
| A-P03 |
用量监控 |
平台整体用量统计 |
| 编号 |
功能 |
说明 |
| A-F01 |
明细核心数据看板 |
API 调用总量、用户数 |
| A-F02 |
实时用量 |
当前分钟级 API 调用 QPS |
| A-F03 |
告警通知 |
异常用量、系统异常提醒 ？ |
| 编号 |
功能 |
说明 |
| A-F04 |
全局 Key 列表 |
查看平台所有 API Key |
| A-F05 |
强制禁用 Key |
发现异常时立即禁用 |
| A-F06 |
Key 使用监控 |
查看 Key 的调用情况 |
| 编号 |
功能 |
说明 |
| A-F07 |
平台总用量 |
整体 API 调用统计 |
| A-F08 |
模型用量分布 |
各模型调用占比 |
| A-F09 |
用户用量排行 |
调用量 Top 用户 |
| A-F10 |
异常用量检测 |
检测异常调用模式 |
落地页 → 定价页 → [登录/注册] → 控制台 → 套餐订阅 → 支付 → 订阅成功
│
┌──────────────────────┼──────────────────────┐
│ │ │
▼ ▼ ▼
API Key 管理 用量统计 订阅管理
│ │ │
▼ │ │
生成 API Key ────────────────┼──────────────────────┤
│ │
▼ ▼
查看调用明细 升级/降级套餐
[登录/注册] 为通用子模块，本文档不展开。
用户请求
│
▼
┌─────────────┐
│ 1. 接收请求 │ ← 兼容 OpenAI / Anthropic 格式
└──────┬──────┘
│
▼
┌─────────────┐
│ 2. 验证 Key │ ← 检查 Key 有效性、是否禁用
└──────┬──────┘
│
▼
┌─────────────┐
│ 3. 检查额度 │ ← 查询用户剩余额度
└──────┬──────┘
│
额度不足? ──是──▶ 返回 429 / 提示购买加油包
│ 否
▼
┌─────────────┐
│ 4. 路由模型 │ ← 根据 model 参数路由到对应模型
└──────┬──────┘
│
▼
┌─────────────┐
│ 5. 调用模型 │ ← 转发请求到上游模型服务
└──────┬──────┘
│
▼
┌─────────────┐
│ 6. 返回结果 │ ← 格式化响应，保持兼容性
└──────┬──────┘
│
▼
┌─────────────┐
│ 7. 扣减额度 │ ← 根据实际用量扣减（或按 Prompt 计数）
└─────────────┘
用户获取 API Key
│
▼
配置到第三方工具（Cursor/Claude Code/VSCode）
│
▼
工具发起请求 ──▶ Alaya Code API ──▶ 模型服务
│
▼
返回结果给工具
| 模型 |
上下文窗口 |
特点 |
适用场景 |
| Kimi2.5 |
200K |
长文本处理强 |
代码审查、长文档分析 |
| Qwen3.5 |
128K |
中文理解优秀 |
中文编程、注释生成 |
| GLM5 |
128K |
代码能力强 |
代码生成、算法实现 |
| 工具 |
对接方式 |
| Cursor |
OpenAI 兼容 |
| Claude Code |
cc-switch 配置 |
| VSCode + Cline |
OpenAI 兼容 |
| OpenCode |
OpenAI 兼容 |
| OpenClaw |
OpenAI 兼容 |
| 接口 |
路径 |
说明 |
| OpenAI Chat Completions |
POST /v1/chat/completions |
标准兼容接口 |
| Anthropic Messages |
POST /anthropic/v1/messages |
Claude 兼容接口 |
mcp的能力：
https://docs.bigmodel.cn/cn/coding-plan/mcp/vision-mcp-server#mcp-%E4%BD%BF%E7%94%A8%E9%A2%9D%E5%BA%A6%E8%AF%B4%E6%98%8E
https://platform.minimaxi.com/docs/coding-plan/mcp-guide
https://www.alibabacloud.com/help/zh/model-studio/web-search-for-coding-plan?spm=a2c63.p38356.help-menu-2400256.d_0_2_3_0.602a7c7cExvflY
