主题
接入概览
Base URL
https://s1.why01.top具体端点路径取决于你用的协议(OpenAI / Anthropic / Gemini),下文有矩阵。
鉴权
所有请求在 HTTP header 加:
Authorization: Bearer sk-你的keysk-... 是控制台「令牌管理」创建的 API Key(详见 创建 / 管理 API Key)。
协议兼容矩阵
本站作为 AI 大模型中转网关,支持以下协议路径:
| 协议 | 端点路径前缀 | 推荐 SDK | 说明 |
|---|---|---|---|
| OpenAI v1(推荐) | /v1/... | openai (Python/Node/Go/...) | 通吃所有模型,包括 Claude 和 Gemini |
| Anthropic 原生 | /v1/messages | anthropic | 仅当你的代码已经在用 anthropic SDK 时考虑 |
| Gemini 原生 | /v1beta/models/{model}:generateContent | google-generativeai | 同上,按需 |
推荐用 OpenAI 协议跑全部模型
绝大多数情况建议直接用 OpenAI SDK 调所有模型——把 model 字段改成 Claude / Gemini 模型名即可。这样:
- 一套代码切模型不改 SDK
- 出问题排查路径单一
- 上游对 OpenAI 协议的兼容性最好(Anthropic / Gemini 原生协议在中转商之间存在差异)
常用端点
下面端点均以 OpenAI 协议为准。完整字段对齐 OpenAI 官方文档。
| 用途 | 端点 | 详见 |
|---|---|---|
| 对话 / Chat | POST /v1/chat/completions | OpenAI 兼容 |
| 流式输出 | 同上,请求体加 "stream": true | 同上 |
| 模型列表 | GET /v1/models | 查可用模型 |
| Embeddings | POST /v1/embeddings | OpenAI 兼容路径 |
| 图像生成 | POST /v1/images/generations | 上游需支持,详见控制台 |
| 音频转写 | POST /v1/audio/transcriptions | 上游需支持 |
| TTS | POST /v1/audio/speech | 上游需支持 |
| 重排序 | POST /v1/rerank | 上游需支持 |
WARNING
Embeddings / 图像 / 音频 / 重排序等非对话端点的支持取决于上游渠道实现。控制台 模型 / 定价页 会标注每个模型支持的能力——以那里展示的为准。如果文档说"应该能用"但调用 404,多半是当前所在用户组的渠道未接入该端点。
限速
本站对令牌不做用户级硬性限速——不需要你在控制台给每个 Key 配「每分钟多少请求」之类。但请求最终会落到上游,上游的限速会以 429 形式返回(OpenAI / Anthropic / Google 各家各自有 RPM / TPM 限制)。
如果你的业务遇到持续 429:
- 自身侧加 exponential backoff 重试(推荐初始 1s,2 倍递增上限 30s)
- 联系客服评估升级到更高优先级用户组(更高用户组通常对应更稳的渠道 / 更宽的上游配额)
内容审核
上游的内容审核(OpenAI moderation、Anthropic safety、Gemini safety settings)全部按上游策略执行——本站不附加额外审核,也不绕过任何上游审核。
数据隐私
本站不记录 prompt 内容、不记录响应正文。仅记录调用元数据(时间、模型名、token 用量、IP 段、状态码)用于计费和审计。详见 服务条款 § 隐私。