公开 Developer Center 设计

ai.oceanway.tech 是 OceanWay 面向开发者和技术决策者的公开产品入口。它的唯一目标是帮助用户完成“发现、理解、评估并开始接入”，不承担任何登录后的客户管理。

Kie.ai 是本页面商业信息层级的主要参考：先表达一个 API 覆盖多种 AI 能力，再用模型、价格、试用、文档和运行可靠性降低接入不确定性。OceanWay 不复制它的视觉或文案，并保留公开 Center、Console AI 与 Public API 三入口边界。

页面职责

目标用户和问题

全站信息架构

ai.oceanway.tech
├── /                         开发者首页
├── /models                   模型目录
│   └── /models/{familySlug}
│       └── /models/{familySlug}/{variantSlug}
├── /docs                     快速开始与开发文档
├── /pricing                  公开列表价与计费规则
├── /status                   客户可理解的服务状态
├── /changelog                模型、协议、价格与平台更新
├── /deprecations             弃用、迁移窗口和替代建议
└── /enterprise               企业接入、支持与 FDE 入口

正式 API Reference 可以与 Developer Center 共用导航和品牌，但其内容构建允许使用独立文档服务。所有 Canonical URL 和站内搜索必须让用户感觉它们属于同一个开发者产品。

全局导航

桌面端

[OceanWay Developer]
[模型] [文档] [价格] [状态] [更新]
                         [联系企业团队] [进入控制台]

• Logo 可以返回 Developer Center 首页，并提供回到 oceanway.tech 的品牌入口；
• “进入控制台”始终指向 console.oceanway.tech/ai，不在当前 Host 建立账户菜单；
• “开始使用”是上下文动作，位于首页 Hero、模型详情和快速开始页面；
• 状态和更新属于开发者信任信息，不藏在页脚；
• 当前页面、键盘焦点和移动端展开状态必须明确。

移动端

首屏只保留品牌、菜单和“进入控制台”。菜单展开后按“发现 → 学习 → 信任 → 合作”排序，不把所有模型分类塞进一级导航。模型能力由目录页筛选承担。

首页信息层级

首页按以下顺序组织。每一段必须回答新的购买或接入问题，禁止用重复口号拉长页面。

1. Hero：一句承诺和三个动作

信息目标：用户立即知道 OceanWay 提供统一模型 API，并同时覆盖开发者调用与生产工作流。

建议表达结构：

标题：一个 API，连接生产级 AI 模型与 OceanWay 工作流
说明：统一接入文本、图像、视频和音频能力；从试用、调用到资产与企业治理保持同一链路。

[探索模型] [阅读快速开始] [进入控制台]

Hero 不使用尚未证明的模型数量、国家数量、可用率或节省比例。需要展示数字时，必须关联统计口径、时间范围和可验证来源。

2. 能力入口：先任务，后模型

提供 5–7 个稳定能力入口，而不是展示几十个 Logo：

每个入口显示典型输入输出、适用场景和推荐 Offering 数量，进入带筛选状态的模型目录。

3. 精选模型：价格、状态和试用同屏

精选区借鉴 Kie.ai 的高信息密度，但只展示经过产品审核的少量 Offering。卡片最少包含：

• Family 与 Variant 名称；
• 能力和输入/输出模态；
• 一句适用场景；
• 公开列表价及其准确计量单位；
• Preview、GA 或 Deprecated 生命周期；
• OceanWay 客户可用状态；
• “查看详情”和“在 Playground 中试用”。

精选由 Product Control 的公开策展配置决定，不按上游模型同步顺序或短期利润自动排名。内部模型和只发布到 web 的工作台模型不进入该区域。

4. 透明价格：展示规则，不制造虚假可比性

首页只展示能够快速理解的价格摘要：

• 不同能力的起始价格或典型计费单位；
• 文本输入/输出 Token、图片、视频秒数、音频时长等单位差异；
• 失败、取消、预占和最终结算的公开解释；
• 公开列表价与企业合同价的边界；
• 查看完整价格和进入 Console 购买的入口。

“与官方价格相比”只有在相同模型、版本、规格、区域、计费单位和生效时间均可证明时才允许出现，并必须标记来源与更新时间。首期不把价格差百分比作为 Hero 核心卖点。

5. 接入路径：三个步骤对应真实系统

媒体示例说明异步 Run、Webhook 或查询；文本示例说明同步或流式响应。不能为了“一套 API”口号把两者描述成完全相同的运行模型。

6. 生产可信度

此区域回答“为什么可以进入生产”：

• 稳定公开模型 ID 与版本/弃用政策；
• 幂等、限流、超时和标准错误；
• 客户可理解的状态与 Incident 通知；
• Request/Run 关联和费用可追溯；
• Environment、Service Account、Credential 和预算治理；
• 企业支持、安全资料和 FDE 接入。

公开页面只描述 OceanWay 服务承诺，不展示双网关内部路由、上游成本、供应凭据或 Provider 级故障。

7. OceanWay 生态

这一段是 OceanWay 与纯 API 聚合商的重要差异：

API 输出 → 正式 Asset → Canvas 编排
                    → AI 漫剧工作台
                    → 电商工作台
                    → Agent / MCP 工作流

页面应通过真实能力和案例说明跨产品链路，不暗示所有 API 结果会自动进入资产库。是否登记正式 Asset 由调用契约、保留策略和客户权限决定。

8. 企业与 FDE

为需要合同价、专属容量、数据政策、模型定制、私有连接或交付服务的客户提供独立入口。公开 Center 只收集合作意向；签约后的组织、权益和交付进入 Console 与 FDE 私有空间。

9. FAQ 与最终动作

FAQ 优先回答接入前高频阻力：支持哪些调用模式、如何计费、失败是否收费、结果保留多久、怎样获得支持、怎样迁移模型、怎样提高配额。答案必须链接到对应正式文档，而不是形成另一份不可维护的事实副本。

CTA 与跨站意图

Center 到 Console 只携带不敏感意图：

intent = playground | open_app | create_credential | purchase
offeringId?
docPath?
returnUrl?

Console 必须校验目标 Origin、重新解析登录和组织上下文，并再次验证 Offering 是否对当前 App、Environment 和付款主体可用。URL 不得携带 Secret、余额、角色、合同价或内部路由信息。

登录状态的表现

公共 Center 可以通过普通链接显示统一的“进入控制台”，但页面主体不读取 Customer Session，也不按登录身份个性化内容。

采用这一限制的原因：

• Center 可以独立缓存和部署；
• 不扩大跨子域 Cookie 和客户信息泄露范围；
• 登录状态异常不会影响公开模型与文档；
• 所有客户上下文只在 Console 被可信解析；
• 用户不会误以为 Center 与 Console 是两套账户系统。

内容与数据来源

首页、模型页、价格页、API Reference 和 Console 不能各自手写同一组价格、模型状态或参数定义。

页面状态

响应式与无障碍要求

• 390px 和 430px 下 Hero、能力入口、精选模型和价格表无横向滚动；
• 表格在窄屏转换为语义完整的分组卡片或可访问横向区域，不隐藏计费单位；
• 所有状态不能只用颜色表达，同时显示文字和必要说明；
• 模型卡、筛选、菜单和 CTA 支持键盘操作和清晰焦点；
• 代码示例提供复制反馈、语言标签和可读的错误状态；
• 动效尊重 prefers-reduced-motion，不让模型轮播成为读取内容的唯一方式；
• 中英文内容共享信息结构和 Canonical 规则，不在同一段落混用语言。

关键指标

首页指标用于判断信息架构是否有效，不用于自动改变模型排序：

• 首页到模型目录、详情、文档和价格的进入率；
• 公开模型详情到 Console Playground 的转化率；
• 登录后成功恢复 offeringId + intent 的比例；
• 首次 Playground 成功、首次 Credential 创建和首次 API 成功的完成率；
• 搜索无结果、筛选零结果和模型详情退出率；
• 价格、状态、数据政策和错误文档的访问路径；
• 企业合作入口的有效线索率。

埋点不得记录 Secret、完整 Prompt、上传媒体内容或客户私有参数。

验收标准

1. 未登录用户可以访问首页、模型、文档、价格、状态和更新。
2. 首页在不解释内部网关的情况下说清楚文本与媒体能力、调用模式和 OceanWay 生态差异。
3. 精选模型的名称、价格、状态和试用入口都来自公开 Offering 投影。
4. “在 Playground 中试用”进入 Console，登录后恢复目标 Offering，但不能绕过组织和权限校验。
5. Center 页面、请求、Cookie 和缓存中不出现客户组织、余额、Credential 或合同价。
6. 文本流式与媒体异步路径分别被准确说明。
7. 390px、430px、桌面宽度、键盘、浅深主题和无动画偏好均通过页面回归。
8. Center 不可用不影响既有 API；Console 或 API 故障不把 Center 变成错误登录页。