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

OpenAI 兼容 API

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

ToRouter 在所有 OpenAI SDK 用到的 endpoint 上都是原生兼容的。只需要改 base_url 和密钥,业务代码一行都不动。

Endpoint

方法路径用途
POST/v1/chat/completions聊天(上游 OpenAI / Anthropic / Gemini / OpenRouter 通吃)
POST/v1/responsesResponses API(推理、工具调用、多轮状态)
POST/v1/embeddings文本向量化
POST/v1/images/generations文生图
POST/v1/images/edits图像编辑(multipart)
GET/v1/models列出可用模型

工具/函数调用、JSON 模式、response_format、tool_choice、结构化输出全部原样透传。

Python SDK

example.py
from openai import OpenAI

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

resp = client.chat.completions.create(
    model="gpt-5",
    messages=[{"role": "user", "content": "用 17 字写一首关于路由器的俳句"}],
)
print(resp.choices[0].message.content)

同一个 client 同样用于 client.embeddings.create(...)、client.images.generate(...)、client.responses.create(...)。

curl

curl https://portal.torouter.ai/v1/embeddings \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/text-embedding-3-small","input":"hello world"}'

Embeddings 仅支持 OpenAI / OpenRouter 分组上的 API Key;model 请使用模型目录中的完整 ID(OpenRouter 常见写法如 openai/text-embedding-3-small)。网关也支持 /api/v1/embeddings 路径。

OpenAI 兼容层同时托管 Anthropic 与 Gemini 上游——如果分组接的是 Claude / Gemini 账号,gpt-5 风格模型会自动翻译。详见 模型标识。

下一步

流式响应

打开 stream: true。

Python 集成

完整 SDK 接入指南。

Node.js 集成

TypeScript 版本。

Base URL 与鉴权

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

Anthropic 兼容 API

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

目录

EndpointPython SDKcurl下一步