接入文档

业务侧只需将 base_url 指向本网关、使用平台下发的 sk-safe- 前缀密钥，即可通过统一接口调用全部已纳管的国产大模型与内网自建模型，无需管理各厂商的账号与凭据。 网关在服务端完成智能路由、故障转移、限流配额、成本核算与全链路审计，业务代码零改造切换底层模型。

请联系平台管理员，在控制台「密钥与租户」页面为对应业务租户创建 API 密钥。 出于安全考虑，密钥明文仅在创建时显示一次， 平台仅存储其哈希值，无法二次找回；请创建后立即妥善保存（建议存入企业密钥管理系统）。 若密钥遗失或疑似泄露，应立即在控制台吊销并重新创建。

向 POST /v1/chat/completions 发起请求，鉴权使用 Authorization: Bearer 请求头。curl 示例：

curl https://your-gateway/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-safe-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      { "role": "user", "content": "总结一下本周产线设备的报警日志要点" }
    ]
  }'

Python（openai 官方 SDK）示例，仅需替换 base_url：

from openai import OpenAI

# base_url 指向网关的 /v1，其余用法与官方 SDK 完全一致
client = OpenAI(
    base_url="https://your-gateway/v1",
    api_key="sk-safe-xxxxxxxxxxxxxxxx",
)

resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "生成一份注塑车间设备巡检要点清单"}],
)
print(resp.choices[0].message.content)

向 POST /v1/messages 发起请求，鉴权使用 x-api-key 请求头，并携带 anthropic-version: 2023-06-01：

curl https://your-gateway/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-safe-xxxxxxxxxxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "glm-4.6",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "分析这段设备振动数据的异常趋势" }
    ]
  }'

Claude Code 等 Anthropic 生态工具可直接将上游指向本网关，仅需设置两个环境变量：

# 将 Claude Code 的上游指向本网关，即可直连已纳管的国产模型
export ANTHROPIC_BASE_URL=https://your-gateway
export ANTHROPIC_AUTH_TOKEN=sk-safe-xxxxxxxxxxxxxxxx

claude

网关会自动将 Anthropic Messages 协议适配为 OpenAI 兼容协议后转发至国产模型上游， 工具调用、流式输出等能力按上游模型的实际支持情况透传，业务侧无需感知底层差异。

在请求体中加入 "stream": true，网关即以 Server-Sent Events（SSE）形式逐段返回内容，OpenAI 与 Anthropic 两种协议端点均支持。

{
  "model": "deepseek-chat",
  "stream": true,
  "messages": [
    { "role": "user", "content": "逐条解读这份工艺变更单" }
  ]
}

平台支持将厂内 GPU 集群部署的 vLLM 服务与产线边缘侧的 Ollama 服务统一纳管， 与云端国产模型共用同一套鉴权、路由与审计体系。所有上游凭据经 AES-256-GCM 加密后落库， 明文密钥不出服务端。整套网关可在内网完全离网自建运行，满足信创与数据不出厂的合规要求。 私有化部署方案请联系平台管理员评估。