调用网关
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/responses | Responses API(推理、工具调用、多轮状态) |
POST | /v1/embeddings | 文本向量化 |
POST | /v1/images/generations | 文生图 |
POST | /v1/images/edits | 图像编辑(multipart) |
GET | /v1/models | 列出可用模型 |
工具/函数调用、JSON 模式、response_format、tool_choice、结构化输出全部原样透传。
Python SDK
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 风格模型会自动翻译。详见 模型标识。