入门
认证方式
不同供应商的鉴权字段不同,但密钥的值永远是本系统内的 Access Token
Base URL 一览
| OpenAI | https://api.hai.network/openai |
| Anthropic | https://api.hai.network/anthropic |
https://api.hai.network/google | |
| 火山引擎 | https://api.hai.network/volcengine |
| OpenAI 兼容接口 | https://api.hai.network/compatible-preview/openai |
| Anthropic 兼容接口 | https://api.hai.network/compatible-preview/anthropic |
| 统一接口(灰度测试) | https://api.hai.network/unified-preview/openai |
关于 Relay Mode API
为降低用户使用多种先进 AI 模型的门槛,HAI Gateway 提供了原生 API Relay 功能。通过集成 OpenAI、Anthropic、Google 等主流 AI 平台的官方 API 接口,用户无需自行注册、申请密钥或配置复杂参数,就能直接体验包括 Claude Code 在内的多种第三方 AI 工具。
最容易踩坑:Header 名称不同
OpenAI 用 Authorization: Bearer xxx,Anthropic 用 x-api-key: xxx,Google 用 x-goog-api-key: xxx。请根据实际使用的供应商来调整鉴权字段!
| 供应商 | 鉴权方式 | 备注 |
|---|---|---|
| Anthropic | x-api-key: sk-pat-xxx | 必须带 anthropic-version: 2023-06-01 |
| OpenAI | Authorization: Bearer sk-pat-xxx | 完全对齐官方 API |
| Google AI | x-goog-api-key: sk-pat-xxx | 也可用 Query 参数 ?key=sk-pat-xxx |
| 火山引擎 | Authorization: Bearer sk-pat-xxx | Seedream 图片生成端点,与 OpenAI 一致 |
| 通义 QWEN | Authorization: Bearer sk-pat-xxx | 预览通道;走 Anthropic Messages 时用 x-api-key |
| 智谱 GLM | Authorization: Bearer sk-pat-xxx | 同上;走 Anthropic Messages 时用 x-api-key |
| DeepSeek | Authorization: Bearer sk-pat-xxx | 同上;走 Anthropic Messages 时用 x-api-key |
| Kimi | Authorization: Bearer sk-pat-xxx | 同上;走 Anthropic Messages 时用 x-api-key |
| MiniMax | Authorization: Bearer sk-pat-xxx | 同上;走 Anthropic Messages 时用 x-api-key |
关于百炼预览通道
通义 QWEN、智谱 GLM、DeepSeek、Kimi、MiniMax 通过独立的预览网关 https://api.hai.network/compatible-preview 提供服务,与上面三家 Relay Mode 网关相互独立。所有通道使用同一种 Access Token(sk-pat- 前缀),但不同通道之间路由与计费独立,请按目标供应商选择对应的 Base URL 与 model 字段。详细调用方式见各供应商专属文档。
关于统一接口预览通道
unified-preview 是一个实验性通道:用户用 OpenAI 格式即可调用 Anthropic / Google 等其他厂商的模型,由网关自动探测并完成格式转换。该通道目前处于灰度阶段,仅对部分租户开放,认证字段与 OpenAI Relay 一致(Authorization: Bearer sk-pat-xxx)。详细调用方式与已知限制见专属章节。