统一协议调度

功能实验室用于提前说明正在设计和验证的能力方向：让调用方通过 https://api.ggpu.ai，按 OpenAI 或 Anthropic 协议接入，再由GGPU平台统一调度模型能力。

状态：规划中。 本页描述目标形态，不代表 OpenAI 与 Anthropic 两种协议已经完整开放。当前可用接口、请求字段和返回格式仍以正式发布的 API 文档与实际响应为准。

当前能力与规划方向

统一入口使用 https://api.ggpu.ai 作为 GGPU API Base URL继续保持同一网关入口

调用协议按当前已发布接口文档接入兼容 OpenAI 与 Anthropic 两类协议习惯

模型选择使用当前账号可用的模型 ID协议与模型调度解耦，由平台承接路由

请求与返回以各正式接口的实际结构为准在协议边界内完成适配与结果返回

上线范围已发布能力可用于正式接入按验证结果逐步开放，不在本页承诺时间

统一协议调度的规划方向

调用侧协议OpenAI / Anthropic按既有客户端习惯组织请求

统一网关api.ggpu.ai识别协议、适配请求并执行调度

能力执行模型与任务按模型能力和平台配置完成调用

调用方选择自己熟悉的协议表达请求，GGPU网关负责识别协议并进入统一调度链路。模型是否可用、选择哪个模型和最终执行状态，仍以账号配置与平台实际响应为准。

变化	对调用方的价值
Base URL 统一	多种接入方式都面向 `https://api.ggpu.ai`，减少地址分散
协议入口统一管理	现有 OpenAI 或 Anthropic 客户端可以沿熟悉的消息结构演进
协议与调度分层	业务代码关注协议和模型，平台承接后续路由变化
鉴权与运营集中	凭证、用量、任务和排障仍在同一平台链路中管理

协议兼容不等于两个协议的字段会被强行合并成一套。OpenAI 与 Anthropic 的消息、流式事件、错误和工具调用语义存在差异，正式能力会分别说明兼容范围。

将 Base URL 配置为 https://api.ggpu.ai，并与 API Key、模型名称分开管理。不要在业务代码里拼接其他临时域名。

把客户端初始化、消息格式、流式解析和错误处理封装在独立模块中，避免业务逻辑直接依赖某一种协议的全部字段。

模型 ID 通过配置注入，运行时以当前账号可用列表为准。不要把平台内部调度来源写死在调用侧。

在切换协议前，逐项确认接口路径、鉴权、消息结构、流式事件、错误格式、工具调用与计费口径，再完成回归测试。

在这些契约正式发布之前，本页不提供可复制的“预测版请求代码”，避免实验说明被误当成生产接口。