API接入与鉴权

完整请求地址 = https://api.sagelib.com + 协议后缀 + 端点路径，例如 https://api.sagelib.com/openai/chat/completions；OpenAI 兼容模式用站点根，不带 /openai 也不带 /v1。鉴权按入口用 Bearer、x-api-key 或 x-goog-api-key。

最后更新：2026-11-14

本文档提供 SageLib AI 边缘网关 模型接口使用说明，指导您完成请求地址、鉴权等配置，实现快速调用。

接入概述

SageLib AI 边缘网关 采用统一的接入架构。在调用 API 时，您需要构造规范的请求地址，并在 HTTP 请求头中携带有效的鉴权令牌（API Key）。

为了满足不同终端接入需求，网关通过协议后缀来区分调用模式。完整的请求地址由 3 个部分拼接而成：

完整请求地址 = {BASE_URL} + {协议后缀} + {终结点路径}

参数定义：

参数 说明
{BASE_URL} 网关的基础服务地址，即站点域名 https://www.sagelib.com，四个入口共用
{协议后缀} 用于指定网关转发的协议（例如 /openai）；使用 OpenAI 协议兼容模式时无需该后缀
{终结点路径} 标准的大模型 API 功能路径（例如 /chat/completions）

协议后缀与终结点需成对使用（如 /messages 只走 Anthropic 入口）；模型还需声明对应的协议与端点， 否则网关会在入口直接拒绝。

配置 Base URL 及鉴权

站点域名

平台提供统一的网关调用地址，请在您的代码或客户端中配置以下基础请求路径。Base URL 的值为：

https://www.sagelib.com

接口鉴权（API Key）

您可通过控制台创建并获取鉴权令牌。网关采用标准的请求头鉴权，不同协议入口使用不同的请求头：

协议入口 鉴权请求头
OpenAI 协议兼容 / OpenAI 协议 Authorization: Bearer <key>
Anthropic 协议 x-api-key: <key>（另需 anthropic-version: 2023-06-01）
Gemini 协议 x-goog-api-key: <key>

选择接入模式与调用协议

OpenAI 协议兼容模式（裸根入口）：站点根即 OpenAI 兼容入口，路径不带 /openai、也不带 /v1， 与上游保持一致；适合会自动拼 /chat/completions 的 OpenAI 兼容客户端。

原生透传协议（OpenAI / Anthropic / Gemini）：以 /openai、/anthropic、/gemini 前缀把请求 直接透传给对应厂商的原生协议，最大化保留各厂商原生的参数与工具能力。

当目标模型同时支持以上两种接入方式时，推荐优先使用原生透传协议。

协议请求地址对照表

接入模式 / 协议 协议后缀 Base URL / 认证头 支持的端点
OpenAI 协议兼容 无 https://www.sagelib.com
Authorization: Bearer <key>		 /chat/completions、/responses、/images/generations、/images/edits、/videos
OpenAI 协议 /openai https://www.sagelib.com/openai
Authorization: Bearer <key>		 同上（/openai/... 与 /openai/v1/... 等价）
Anthropic 协议 /anthropic https://www.sagelib.com/anthropic
x-api-key: <key>（另需 anthropic-version）		 /messages（也收 /v1/messages）
Gemini 协议 /gemini https://www.sagelib.com/gemini/v1beta
x-goog-api-key: <key>		 models.generateContent、models.streamGenerateContent、/interactions

调用示例

# OpenAI 协议兼容入口（站点根）
curl -X POST "https://www.sagelib.com/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SAGELIB_API_KEY" \
  -d '{"model":"<模型标识>","messages":[{"role":"user","content":"你好"}]}'

# OpenAI 协议入口（/openai，带不带 /v1 都行）
curl -X POST "https://www.sagelib.com/openai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SAGELIB_API_KEY" \
  -d '{"model":"<模型标识>","messages":[{"role":"user","content":"你好"}]}'

# Anthropic 协议入口（base 不写 /v1，客户端自己拼）
curl -X POST "https://www.sagelib.com/anthropic/v1/messages" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $SAGELIB_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"<模型标识>","max_tokens":256,"messages":[{"role":"user","content":"你好"}]}'

# Gemini 协议入口（base 带 /v1beta）
curl -X POST "https://www.sagelib.com/gemini/v1beta/models/<模型标识>:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $SAGELIB_API_KEY" \
  -d '{"contents":[{"parts":[{"text":"你好"}]}]}'

模型标识与现成示例

填地址的四条规则

参考来源