认证与 Base URL
本页是全站 Base URL 与鉴权方式的唯一事实源，其他页面只做引用。
核心心智
一个 API Key 走遍所有厂商。接入任何 SDK 通常只需改两处：base_url 和 api_key。
真正需要注意的只有两件事——Base URL 要不要带 /v1，以及用哪个鉴权 Header。
Base URL
正式域名两个，都指向同一套服务：
| 域名 | 状态 |
|---|---|
https://api.smartwan.com | 当前可用，示例均以此为准 |
https://api.tokenroute.com | 正式域名，尚未启用；启用后两者并行服务，无需更换 API Key |
接口路径
完整地址 = https://api.smartwan.com + 接口路径。
| 协议 | 接口路径 |
|---|---|
| OpenAI 兼容 | /v1/chat/completions、/v1/models |
| Anthropic Messages | /v1/messages |
| Google Gemini | /v1beta/models/{model}:generateContent |
| Responses API | /v1/responses |
| 图片生成 / 编辑 | /v1/images/generations、/v1/images/edits |
例：OpenAI 对话补全的完整地址是 https://api.smartwan.com/v1/chat/completions。
/v1 加还是不加
用 SDK 时，base_url 填到 /v1 为止：https://api.smartwan.com/v1，SDK 会自己拼后面的 /chat/completions。
用 curl 时，写完整路径。
用客户端工具时，看工具页说明——有的自动补 /v1，重复填会得到 /v1/v1/... 然后报 404。
鉴权
Header 名称各协议不同，但填的都是同一个 API Key。
| 协议 | Header |
|---|---|
| OpenAI 兼容 | Authorization: Bearer sk-你的Token |
| Anthropic Messages | x-api-key: sk-你的Token |
| Google Gemini | x-goog-api-key: sk-你的Token，或查询参数 ?key=sk-你的Token |
最常见的错误
拿 OpenAI 的 Authorization 头去调 /v1/messages，或者反过来。Header 名称必须与接口协议匹配，混用会直接 401。
Anthropic 协议建议带上 anthropic-version: 2023-06-01。当前环境不强制，但保留可兼容官方 SDK 行为。
各厂商走哪个协议
DeepSeek、智谱 GLM、Kimi、MiniMax 等模型都通过统一的 OpenAI 兼容接口调用，也支持 Anthropic Messages 格式：
| 厂商 | OpenAI 兼容 | Anthropic Messages | Gemini 原生 |
|---|---|---|---|
| OpenAI | ✅ | — | — |
| Anthropic | ✅ | ✅ | — |
| ✅ | — | ✅ | |
| DeepSeek | ✅ | ✅ | — |
| 智谱 GLM | ✅ | ✅ | — |
| Kimi | ✅ | ✅ | — |
| MiniMax | ✅ | ✅ | — |
走哪个协议就用哪个协议的 Header 和路径。各家的具体参数差异见厂商调用差异。