# SageLib AI 边缘网关 API（OpenAPI 摘要）

> 国内外顶尖大模型的统一 API 入口 · 无需 VPN · 按量计费 · 透明账单

机器可读规范：`https://www.sagelib.com/openapi.json`（OpenAPI 3.1）

## 入口

| 用途 | Base URL | 鉴权头 |
| --- | --- | --- |
| OpenAI 兼容 | `https://api.sagelib.com` | `Authorization: Bearer <令牌>` |
| OpenAI 协议 | `https://api.sagelib.com/openai` | `Authorization: Bearer <令牌>` |
| Anthropic 协议 | `https://api.sagelib.com/anthropic` | `x-api-key: <令牌>` |
| Gemini 协议 | `https://api.sagelib.com/gemini/v1beta` | `x-goog-api-key: <令牌>` |

## 端点

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| POST | `/chat/completions` | OpenAI 兼容对话补全 |
| POST | `/openai/chat/completions` | OpenAI 对话补全 |
| POST | `/openai/responses` | OpenAI Responses |
| POST | `/anthropic/v1/messages` | Anthropic Messages |
| POST | `/gemini/v1beta/models/{model}:generateContent` | Gemini generateContent |
| POST | `/images/generations` | 图像生成 |
| POST | `/videos` | 视频生成（异步，轮询 /videos/{id}） |
| GET | `/videos/{id}` | 视频任务状态 |
| POST | `/audio/transcriptions` | 语音转写 |
| POST | `/audio/speech` | 语音合成 |
| GET | `/models` | 令牌可用模型列表 |
| GET | `/user/balance` | 令牌余额 |

## 错误

401 鉴权失败 / 402 余额不足 / 403 模型或 IP 无权限 / 404 路径不对 / 429 频率或配额 / 502 上游失败。

模型清单与单价：`https://www.sagelib.com/llms.txt`