# API OpenMagic Page Blueprints

## 1. 页面设计原则

- 页面不是为了“看起来像模板”，而是为了转化。
- 首屏必须让用户快速理解：
  - 这是做什么的
  - 为什么值得用
  - 如何开始
- 免费聊天不是主角。
- 咨询入口全站可见，但不能压过主 CTA。

---

## 2. `openmagic.ai` 首页模块草图

### 模块 1：Hero

目标：

- 明确这是 OpenMagic 的 AI API 产品入口
- 同时保留品牌站气质

建议内容：

- 标题：统一接入主流 AI 模型
- 副标题：按量计费、月度套餐、中文文档、企业支持
- 主按钮：
  - 开始接入
  - 查看定价
- 次按钮：
  - 免费体验 AI 聊天

### 模块 2：核心卖点

- 一个 Base URL
- 多模型接入
- 开发者友好
- 企业支持

### 模块 3：场景展示

- 开发者调用 API
- AI 工作流
- 团队协作
- 企业试点

### 模块 4：产品导流

- API 产品站入口
- 文档入口
- 定价入口
- 企业合作入口

### 模块 5：内容区

- 最新 AI 资讯
- 热门文章
- 教程精选
- 模型更新

### 模块 6：页脚 CTA

- 注册获取 API Key
- 联系咨询

---

## 3. `api.openmagic.ai` 首页模块草图

### 模块 1：Hero

目标：

- 高转化
- 明确产品定位

建议内容：

- 标题：One API access point for leading AI models
- 副标题：面向中文市场的统一模型接入与计费平台
- CTA：
  - 立即注册
  - 查看定价
  - 阅读文档

### 模块 2：模型兼容

- OpenAI-compatible
- Claude / Gemini / other providers
- SDK 与客户端支持说明

### 模块 3：开发者接入

- curl 示例
- OpenAI SDK 示例
- 客户端列表

### 模块 4：定价概览

- 按量充值
- 月度套餐
- 企业方案

### 模块 5：为什么选择我们

- 统一接入
- 中文文档
- 稳定线路
- 可咨询支持
- 开发者友好控制台

### 模块 6：轻量体验

- 免费 AI 聊天入口
- 只作体验，不喧宾夺主

### 模块 7：FAQ

- 支持哪些模型
- 如何获取 API Key
- 如何收费
- 是否支持企业合作

### 模块 8：页脚

- 文档
- 定价
- 服务状态
- 企业合作
- 咨询入口

---

## 4. 定价页模块草图

### 模块 1：价格总览

- 三档结构：
  - 按量
  - 月度
  - 企业

### 模块 2：按量说明

- 适合测试和轻量调用
- 充值即用
- 按实际消耗计费

### 模块 3：月度套餐说明

- 固定月费
- 固定额度
- 更适合高频用户

### 模块 4：企业方案

- 对公合作
- 定制额度
- 优先支持

### 模块 5：FAQ

- 是否自动续费
- 是否可退款
- 套餐是否可升级

---

## 5. 文档页结构

### 一级入口

- 快速开始
- OpenAI 兼容接入
- 模型列表
- 价格说明
- 常见客户端配置
- 错误码与排障

### 二级重点

- Cursor
- Cline
- Claude Code
- Codex
- OpenAI SDK

---

## 6. 控制台页结构

### 控制台首页

- 当前余额/额度
- 当前套餐
- 最近用量
- 最近订单
- 快捷入口

### `Keys`

- 创建 API Key
- 查看状态
- 删除/禁用

### `Usage`

- 今日/本月用量
- 模型级消耗
- 时间维度统计

### `Billing`

- 充值
- 当前余额
- 月度套餐状态

### `Orders`

- 历史订单
- 支付状态

### `Invites`

- 我的邀请链接
- 邀请奖励记录

---

## 7. 咨询与免费聊天挂载位

### 咨询

- 全站右下角悬浮
- 首页、定价页、企业页优先显示

### 免费聊天

- 首页次级入口
- 控制台空态页可放辅助入口
- 不作为顶级导航主项也可以接受