AI Gateway
客户端不持有 MiniMax Key。Worker 统一处理 Session / API Key 鉴权、请求体解析、Provider 调用、SSE 透传和用量记录。
StudyPulse Cloud AI / 0.7-beta
边缘服务在线
高性能边缘 AI 网关
与统一身份中心。
一层部署在 Cloudflare Workers 上的 AI 网关与统一身份中心。
为 StudyPulse iOS App 和 Web 用户代理 MiniMax-M3 多模态调用，并把账号认证、额度、会员、请求审计、支持流程和贡献激励收束到同一套边缘服务中。
StudyPulse Cloud AI
One identity · One gateway · One usage model
GATEWAY
代理多模态流式调用与速率限制
IDENTITY
统一 Session、密码、验证码与 GitHub OAuth
PRIVACY
数据库 0 留存 prompt 与 reply 对话内容
POST /v1/chat
HTTPS · SSE · D1 State
spapi.chenkai.space
spapi.chenkai.space
19
D1 migrations 数据迁移
3
登录方式：密码 / 验证码 / GitHub
2
鉴权上下文：Session / API Key
0
保存的 prompt / reply 对话
01 / 概述
集模型代理、身份认证、额度审计
集模型代理、身份认证、额度审计
与运营管理于一体的边缘架构。
Cloud AI 把 StudyPulse 的客户端、身份、模型调用、会员与支持系统连接起来。每个模块都有清晰的边界，也共享同一个 userId、用量和会员上下文。
统一身份中心
邮箱密码、邮箱验证码与 GitHub OAuth 最终关联同一个 users.id，不会产生第二套会员或额度体系。
完整运营体系
管理后台覆盖 Key CRUD、用户、会员、封禁、申诉、反馈工单、请求日志和管理员审计。
02 / 请求生命周期
一条 /v1/chat 请求，
一条 /v1/chat 请求，
如何走完完整生命周期。
流式与非流式路径共享鉴权和 Provider 层，但在额度检查、用量提取和响应形态上分别处理。
01
authenticateRequest()
优先识别 sp_sess_ Session；失败直接 401，不回退到 API Key。随后检查 X-API-Key，再兼容 Authorization: Bearer sp_beta_xxx。
02
Normalize input
content[] 多模态数组优先于 message 字符串，统一组装为 [{ role: 'user', content }]。
03
Quota & model check
读取会员计划，检查每日请求与当月 Token；admin 角色跳过用户额度，并验证计划是否可用指定模型。
04
MiniMax provider
固定调用 api.minimaxi.com 的 OpenAI-compatible endpoint，使用服务端 Secret，客户端不能覆盖 provider 配置。
05
Record usage
成功调用后更新 api_keys 计数、写入 usage_records，并通过 ctx.waitUntil() 异步写 request_logs；失败请求不计次。
04 / 产品表面
完整的管理控制台
完整的管理控制台
与用户自服务界面。
从登录、用户仪表盘到后台 Key、请求日志与反馈工单，StudyPulse Cloud AI 不只提供 API，也提供一套可运营的产品闭环。
