统一协议入口
以 RESTful API 为主要接入方式，围绕 OpenAI 风格的 Chat Completions、Responses API 组织接口适配与测试。
MAAS · MODEL ACCESS & ROUTING
MaaS 模型平台
统一接入与路由。
面向企业的多模型 API 接入方案。
围绕协议适配、模型路由、访问鉴权与请求级计量，
把模型调用接入现有业务系统。
协议适配授权路由请求级核对
BERLIN / MODEL ACCESS方案示意
POST
/v1/chat/completions业务请求鉴权与策略检查模型与能力映射
BERLIN Gateway模型服务接入与路由层
ROUTE 01商用模型接口与能力适配
ROUTE 02备用渠道授权范围内切换
ROUTE 03专属资源项目独立配置
REQUEST ID贯穿响应、日志与用量记录
具体模型、协议与服务等级在接入方案及联调验收中确认。
01接口有约定明确输入、输出与错误语义
02路由有边界围绕模型、区域与授权选路
03调用可核对区分用量、单价与消费金额
01 — SERVICE BLUEPRINT
在应用与模型之间，
建立一层清晰的秩序。
从一条 API 请求出发，把接入过程拆解为可以设计、测试和核对的环节。
原生能力映射
逐模型核对工具调用、缓存信息、推理参数、结构化输出与多模态能力，明确透传、转换和不支持的边界。
模型与渠道路由
围绕模型 ID、区域、容量与授权条件设计选路策略。备用路线纳入同一能力和费用口径核对。
鉴权与数据边界
将 API Key、AK/SK 签名、IP 白名单及权限范围纳入接入设计，明确 HTTPS、敏感凭据保护与日志脱敏要求。
连续性与故障处理
设计健康探测、错误分类、限次重试、熔断与回退机制，并通过故障演练确认异常情况下的处理方式。
请求级用量核对
以请求标识关联模型、渠道与 Token 明细，分别记录计量依据和金额口径，为项目对账提供可追溯的记录结构。
服务设计范围
以上内容用于说明可讨论的方案与验收范围。具体模型、功能、鉴权方式和配置在联调后确认，不代表全部功能默认启用。
02 — INTERFACE CONTRACT
接口格式熟悉，
能力边界明确。
统一接口不应抹平模型差异。先明确协议映射，再逐项验证模型实际开放的功能和返回字段。
01请求与响应约定参数映射、状态码、错误结构与请求标识。
02流式与实时交互SSE 流式响应纳入测试；WebSocket 或 gRPC 按具体低延迟场景另行评估。
03原生能力一致性对工具、缓存、推理相关参数及可用输出逐项联调；原生未开放的信息不作为返回承诺。
POST
/v1/chat/completions接口约定示例# BASE_URL 包含确认后的 /v1 路径
# MODEL_ID 与 API_KEY 使用项目开通信息
curl "$BASE_URL/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [
{"role": "user", "content": "你好"}
],
"stream": true
}'请求结构示例HTTPS / JSON / SSE
示例用于说明接口格式，复制操作不会发起调用。实际 API 地址、模型清单与参数支持范围在项目接入时提供；官网地址不是模型 API。
03 — ROUTING & CONTROL
每一次选路，
都应有清楚的依据。
将授权条件、服务状态和调用记录放进同一条处理链路。
策略先定义，行为再验证。
POLICY DESIGN方案示意
在授权集合内选择路线
以项目约定的模型、供应渠道和区域作为选路约束，再结合能力、限额与优先级确定候选路线。
项目权限→模型映射→候选筛选→策略选路
- 明确模型 ID 与供应渠道映射，记录版本差异。
- 备用路线遵循同一授权边界，不默认跨区域或替换模型。
- 保留选路结果与请求标识，便于问题追踪。
04 — ENGINEERING & ACCEPTANCE
把技术要求，
落到可验证的交付项。
从协议一致性到性能与运维，
在同一份验收范围中明确测试条件和交付材料。
| 验收维度 | 方案与验证要点 | 建议交付材料 |
|---|---|---|
| 协议适配API CONTRACT | REST、Chat Completions、Responses；流式事件、错误码、结构化错误与请求标识。 | 接口约定 · 正反向测试记录 |
| 原生能力MODEL CAPABILITIES | 逐模型核对缓存相关字段、工具调用、推理参数、结构化与多模态输出；标明差异与限制。 | 模型能力矩阵 · 一致性用例 |
| 安全与鉴权ACCESS & DATA | API Key / AK/SK 鉴权适配、HTTPS、密钥保护；按项目确认 IP 白名单、签名及脱敏规则。 | 鉴权测试 · 权限与数据范围说明 |
| 性能与服务连续性PERFORMANCE | 分别核对可用性统计、请求耗时 P99 与首 Token 耗时 P99；明确并发、区域、样本和输入输出长度。 | 联合测试报告 · 服务等级约定 |
| 故障切换与回退FAILURE HANDLING | 覆盖超时、限流、节点异常、备用路线、限次重试与版本回退；单独处理流式中断和重复计费边界。 | 故障演练 · 回退操作记录 |
| 技术支持与问题闭环SUPPORT PROCESS | 明确技术接口人、P1 / P2 分级、响应和闭环时限，约定问题升级、版本变更与回退流程。 | 对接机制 · 分级响应流程 |
| 用量、费用与日志REQUEST ACCOUNTING | 请求级 Token 核对；按厂商、模型和项目聚合调用量、错误率与时延；金额单列，日志范围与留存按需确定。 | 计量字段说明 · 对账样例 · 指标口径 |
显示 7 项验收范围
该清单用于技术方案讨论，未列示实测达标结果。性能指标、响应时限及服务等级由联合测试与双方确认的项目方案确定。
05 — GET CONNECTED
从接入沟通，到有据可查的交付。
确认接入范围
梳理应用场景、模型清单、区域、授权和预计用量。
开展联合验证
根据约定用例验证接口、模型功能、安全与故障处理。
核对计量与口径
对齐请求记录、Token 分类、费用项与数据留存范围。
交付与运维对接
确认服务等级、联络机制、问题升级和变更流程。
BERLIN (HK) LIFE SCIENCE
模型即服务，
从每一次 API 调用出发。
柏林（香港）生命科學有限公司围绕企业 AI 与云服务开展业务，将模型接入、应用集成与云基础设施衔接，为企业客户提供项目化的技术方案与交付服务。
MaaS 是连接模型资源与业务应用的服务入口。我们关注接口是否清晰、路由是否可控，以及每一次调用能否被正确核对。
BEFORE INTEGRATION
接入前，
你可能关心这些。
如何开始企业接入？+
通过业务邮箱说明使用场景、模型需求、区域及预计用量。我们据此梳理接口、授权和交付范围，再安排技术方案沟通与联调。
兼容接口是否意味着所有模型功能相同？+
不完全相同。参数、流式事件、工具调用、缓存与推理相关能力需要按模型逐项映射。接入清单会明确支持方式、差异和限制，避免统一接口掩盖原生能力差异。
能否约定性能、故障处理与运维标准？+
可以围绕具体项目制定测试与验收方案，分别定义可用性、请求及首 Token 时延、重试与切换行为、问题响应时限。公开页面不将未经验证的数值列为已达标结果。
可以直接使用官网地址调用模型吗？+
官网用于展示服务与接入方案，不提供公开自助调用。正式 API 地址、可用模型、凭证和计量口径在项目确认后单独提供。