AI 平台接口文档

本文档覆盖平台所有业务模块的 REST API 接口定义，包含请求参数、响应结构、数据模型和使用示例。

文档导航

基础规范

用户与认证

财务

会员与营销

模型与 Token

平台基础设施

快速开始

认证方式

所有接口（除登录/注册外）均需携带认证头：

# 用户界面操作（JWT Token）
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

# 程序调用模型接口（API Key）
Authorization: Bearer sk-prod-xxxxxxxxxxxxxxxx

基础 URL

统一响应格式

{
  "code": 0,
  "message": "success",
  "data": {},
  "request_id": "req_550e8400-e29b-41d4-a716",
  "timestamp": 1704067200
}

错误码速查

详见 00-overview.md。

模块关系图

用户模块 ──── 授权模块（登录/OAuth/RBAC）
     │
     ├── 钱包模块 ──── 交易模块 ──── 账务模块
     │       └────── 订单模块 ──── 计费模块
     │
     ├── 会员模块 ──── 营销模块（代金券）
     │
     ├── Token 模块 ──── 计费模块
     │
     ├── 模型模块（提供商 → 模型 → 对话 → 限流/队列/降级）
     │
     ├── API 网关（路由 / 限流 / Webhook / 审计）
     │
     ├── 通知模块（邮件 / 短信 / 站内信）
     │
     └── 消息中心（收件箱 / 公告）

变更记录