# API OpenMagic Site Architecture

## 1. 项目目标

构建一个面向中文市场的 AI API 中转站，提供：

- 多模型统一接入
- 按量计费
- 月度套餐
- 企业合作入口
- 开发者文档
- API Key 与用量控制台
- 邀请拉新与营销活动能力

该项目不是单一接口网关，而是一整套商业化站点。

---

## 2. 总体架构

建议结构为“两站一核”：

### 2.1 `openmagic.ai`

角色：

- 品牌主站
- 内容主站
- SEO 流量站
- 总入口

职责：

- 保留 WordPress 文章体系
- 保留原有文章 URL、分类 URL、标签 URL
- 首页改造成新商业入口
- 承接自然流量、搜索流量、内容流量
- 向 `api.openmagic.ai` 持续导流

### 2.2 `api.openmagic.ai`

角色：

- 产品站
- 交易站
- 开发者站
- 控制台站

职责：

- 产品首页
- 套餐页
- 模型与费率页
- 文档中心
- 注册/登录
- 用户控制台
- 业务后台入口
- 真实 API 网关入口 `/v1/*`

### 2.3 `One API`

角色：

- 网关内核

职责：

- 上游渠道
- 模型映射
- 分组
- 额度
- Token
- 请求日志
- 用量统计

注意：

- `One API` 不是品牌首页
- `One API` 不承担 CMS 和营销页职责
- `One API` 尽量只做内核，不做大面积前台定制

---

## 3. 双站边界

### 3.1 放在 `openmagic.ai` 的内容

- 品牌首页
- 内容文章
- AI 资讯
- 教程
- SEO 分类页
- 企业介绍
- 对外品牌展示
- 通往 API 站的转化入口

### 3.2 放在 `api.openmagic.ai` 的内容

- 产品首页
- 定价
- 文档
- API Key 管理
- 用量查询
- 充值
- 订单
- 邀请返利
- 企业合作表单
- 真实 API 接口

### 3.3 不建议放在 `openmagic.ai` 的内容

- 真实 `/v1/*` 网关
- One API 后台
- 用户充值主流程
- 复杂控制台逻辑

---

## 4. `openmagic.ai` 页面蓝图

### 4.1 首页

首页采用“上半部分商业入口 + 下半部分内容流量”的门户结构。

上半部分建议模块：

- Hero：统一接入主流大模型 API
- 价值点：多模型、按量+包月、中文文档、企业支持
- CTA：
  - 开始接入
  - 查看定价
  - 免费体验
- 模型接入说明预览
- 套餐概览
- 企业支持
- 咨询入口

下半部分建议模块：

- 最新 AI 资讯
- 热门文章
- 开发者教程
- 模型更新
- SEO 专题入口

### 4.2 文章页

文章页保留现有内容结构，同时增加导流组件：

- 顶部导航加入 API 入口
- 文章中段或侧栏加入 CTA 卡片
- 文章底部加入注册/定价引导
- 咨询组件全站挂载

### 4.3 内容策略

建议新增或强化 AI 相关分类，避免内容和产品方向割裂：

- AI 资讯
- 模型更新
- API 接入教程
- Cursor/Cline/Codex/Claude Code 使用指南
- 企业 AI 应用案例

---

## 5. `api.openmagic.ai` 页面蓝图

### 5.1 面向用户的页面

- `/`
- `/pricing`
- `/models`
- `/docs`
- `/docs/openai`
- `/docs/clients`
- `/enterprise`
- `/playground`
- `/status`
- `/login`
- `/register`

### 5.2 控制台页面

- `/console`
- `/console/keys`
- `/console/usage`
- `/console/billing`
- `/console/orders`
- `/console/invites`
- `/console/profile`

### 5.3 后台与网关

- `/admin`
- `/oneapi`
- `/v1/*`

---

## 6. 免费聊天与咨询入口

### 6.1 免费聊天

来源：

- `chat.openmagic.ai`

定位：

- 附赠能力
- 辅助入口
- 低权重展示

原则：

- 可以在主站和 API 站提供一个“免费体验 AI 聊天”入口
- 不作为主卖点
- 不抢占首页核心视觉
- 重点是增加体验和留存，而不是承担主转化

### 6.2 咨询入口

来源：

- 现有 AI 客服系统

定位：

- 全站咨询承接
- 售前、套餐、接入、企业合作咨询

原则：

- `openmagic.ai` 与 `api.openmagic.ai` 全站可挂
- 后台按“OpenMagic 中转站”品牌单独承接
- 前端只需预留组件和来源标识

---

## 7. 支付与定价

### 7.1 支付模块

原则：

- 不依赖 `One API` 自带支付能力
- 直接接现有支付通道
- 采用独立订单系统
- 支付成功后同步到业务库，再写入或联动 One API 额度体系

### 7.2 定价模块

共识：

- 采用“按量 + 包月”双轨
- 倾向包月
- 最终价格不由主观偏好决定，以中文市场可售性和成熟站点定价趋势为参考

套餐建议分层：

- 按量充值
- 月度专业版
- 企业合作版

---

## 8. 数据库结构

### 8.1 数据库

- `oneapi_core`
- `api_openmagic_biz`

### 8.2 `oneapi_core`

职责：

- One API 原生数据
- 渠道
- 模型
- token
- 分组
- 请求日志
- 用量

### 8.3 `api_openmagic_biz`

职责：

- 用户扩展资料
- 套餐
- 订单
- 支付记录
- 月卡/订阅
- 邀请返利
- 活动
- 营销事件
- 企业客户线索
- 内容位配置

建议业务表方向：

- `om_user_profile`
- `om_plan`
- `om_subscription`
- `om_order`
- `om_payment`
- `om_invoice`
- `om_referral_code`
- `om_referral_event`
- `om_campaign`
- `om_campaign_event`
- `om_enterprise_lead`

---

## 9. 营销与导流

### 9.1 可复用渠道

- `openmagic.ai` 内容流量
- `url.cr` / App 广告图
- 现有品牌渠道
- 老 VPN 用户导流

### 9.2 导流原则

- `openmagic.ai` 负责“拉新”
- `api.openmagic.ai` 负责“成交”
- 咨询系统负责“承接”
- 免费聊天负责“补充体验”

### 9.3 邀请体系

中转站本身要内建传播能力：

- 邀请链接
- 拉新奖励
- 首单奖励
- 返佣或余额返还
- 活动落地页

---

## 10. 视觉方向

视觉目标：

- 吸引人
- 有品牌感
- 有转化感
- 不廉价

已确认原则：

- 白灰色可作为参考，不是硬限制
- 最终以“能吸引用户并促进转化”为第一目标
- 可复用 `chat.openmagic.ai` 的脑图 logo 体系
- 应形成统一的品牌识别而不是随机拼装

建议视觉关键词：

- modern
- clean
- intentional
- developer-friendly
- premium but accessible

---

## 11. 结论

这不是“搭一个接口页”，而是：

- 保留主站流量
- 建立独立 API 产品站
- 用 One API 做内核
- 用自研页面和业务后台做转化
- 用支付、咨询、邀请、活动构成完整商业闭环