Base URL 与鉴权

ToRouter 网关 endpoint 速查表 —— OpenAI / Anthropic / Gemini 协议，同时提供 /v1 与 /api/v1 两套挂载点。

ToRouter 提供三种协议兼容入口。SDK 的 base_url 指向对应路径即可，其余 ToRouter 处理。

Endpoint 速查表

后端将每条网关路径同时挂在 /v1/* 与 /api/v1/* 上，按 SDK 习惯任选其一。

协议	SDK `base_url`	鉴权头
OpenAI	`https://portal.torouter.ai/v1`	`Authorization: Bearer sk-***`
OpenAI（OpenRouter 风格）	`https://portal.torouter.ai/api/v1`	`Authorization: Bearer sk-***`
Anthropic	`https://portal.torouter.ai`	`x-api-key: sk-***` + `anthropic-version: 2023-06-01`
Anthropic（带 `/api`）	`https://portal.torouter.ai/api`	同上
Gemini	`https://portal.torouter.ai/v1beta`	`?key=sk-*` 或 `x-goog-api-key: sk-*`
Gemini（带 `/api`）	`https://portal.torouter.ai/api/v1beta`	同上

Anthropic SDK 会自动拼 /v1/messages，base URL 保持主机根。

快速测试

curl https://portal.torouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5","messages":[{"role":"user","content":"hi"}]}'

curl https://portal.torouter.ai/v1/messages \
  -H "x-api-key: sk-***" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-7","max_tokens":256,"messages":[{"role":"user","content":"hi"}]}'

curl "https://portal.torouter.ai/v1beta/models/gemini-3-flash-preview:generateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"hi"}]}]}'

还没有密钥？见创建第一个 API 密钥。

下一步

OpenAI 兼容 API

Chat / Responses / Embeddings / Images。

Anthropic 兼容 API

原生 /v1/messages。

Gemini 兼容 API

原生 /v1beta。

流式响应

三协议通用 SSE。