RELAY API · DRAFT V1

统一接口先公开,
生产中转待资源接入

以下页面公开字段和错误边界,方便产品提前对接。当前只有目录与状态接口可用;模型调用接口尚未启用,不接收密钥、不产生费用。

当前状态:规范公开 / 生产流量关闭。预留域名 api.hepingopc.com 尚未启用,请勿用于生产。

公开接口

可以直接读取的目录与状态

GET/api/compute/status

查询官网公开的建设阶段与可用性状态

已上线
GET/api/compute/catalog

查询公开产品目录、市场参考价与口径

已上线
GET/api/relay/openapi

查询中转站预留接口清单与字段约束

已上线
GET/v1/models

获取已授权模型目录

未启用
POST/v1/chat/completions

OpenAI 兼容的对话生成入口

未启用

示例

读取公开产品目录

公开接口不需要令牌,不返回供应商凭证、内部地址或客户数据。

curl https://hepingopc.com/api/compute/catalog

{
  "status": "reference_only",
  "currency": "CNY",
  "price_basis": "行业基准·公开后付费价",
  "products": [ ... ],
  "heping_opc_official_price": null
}

中转站契约

模型调用启用前,至少完成六项验收

  1. 01供应商准入

    合同、区域、模型、容量与数据边界完成核验。

  2. 02密钥隔离

    上游密钥只在服务端托管,不进入网页与日志。

  3. 03统一鉴权

    每个企业和项目具有独立凭证、配额与撤销能力。

  4. 04成本对账

    请求、Token、模型、价格版本和账单可以勾稽。

  5. 05错误边界

    超时、限流、余额和上游故障返回稳定错误码。

  6. 06安全审计

    敏感字段脱敏,日志留存周期和访问责任明确。

开发者接入

希望参与接口联调?

提交使用模型、峰值并发、日均 Token、数据区域与上线时间。正式开放后按审核顺序邀请联调。