LogoToRouter 文档
LogoToRouter 文档
首页ToRouter 是什么5 分钟快速开始核心概念
Base URL 与鉴权OpenAI 兼容 APIAnthropic 兼容 APIGemini 兼容 API流式响应(SSE)模型标识与厂商前缀Playground:浏览器内测试
调用网关

Anthropic 兼容 API

在 ToRouter 上直接用官方 anthropic SDK——/v1/messages、count_tokens、prompt caching 与 anthropic-beta 头全部透传。

ToRouter 在 POST /v1/messages 提供原生 Anthropic 接口。官方 anthropic SDK 无需改造,改 base URL 和密钥即可。

Endpoint

方法路径用途
POST/v1/messages发送消息(流式或非流式)
POST/v1/messages/count_tokens预估请求 token 数
GET/v1/models列出可用模型

鉴权头

Anthropic 用 x-api-key,不是 Authorization: Bearer。

x-api-key: sk-***
anthropic-version: 2023-06-01

anthropic-beta 头(如 prompt-caching-2024-07-31、extended-cache-ttl-2025-04-11)以及消息上的 cache_control 块全部透传到上游。

Python SDK

example.py
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-***",
    base_url="https://portal.torouter.ai",
)

msg = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[{"role": "user", "content": "用一句话讲清 CIDR 是什么。"}],
)
print(msg.content[0].text)

SDK 会自动拼 /v1/messages,所以 base_url 写到主机根即可。

curl

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"}]
  }'

当分组 platform 为 OpenAI 或 OpenRouter 时,ToRouter 会把 /v1/messages 透明转换为上游 OpenAI Chat Completions;客户端两种情况下都拿到标准 Anthropic 响应。

下一步

流式响应

stream: true + SSE 增量事件。

Anthropic SDK 集成

完整接入指南,含 Claude Code。

Claude Code

在 Anthropic CLI 中使用 ToRouter。

OpenAI 兼容 API

用 OpenAI SDK 调 ToRouter,覆盖 chat / responses / embeddings / images。

Gemini 兼容 API

原生 Google Gemini /v1beta 接口 —— generateContent、streamGenerateContent、google-genai SDK。

目录

Endpoint鉴权头Python SDKcurl下一步