快速开始
创建 API Key、选择模型并发送第一个请求,确认接入成功。
更新于 2026-10-24·阅读约 3 分钟
SciRouter 的接口兼容 OpenAI Chat Completions、OpenAI Responses 与 Anthropic Messages 三种格式。已调用 OpenAI 接口的代码,将 base_url 设为 https://api.scirouter.cn/v1、Key 换成 SciRouter 的 API Key、model 换成平台的模型 id 即可调用。
| 格式 | 客户端 | 接入说明 |
|---|---|---|
| OpenAI Chat Completions | 已调用 OpenAI 接口的代码 | 本页 |
| Anthropic Messages | Anthropic SDK、Claude Code | Messages(Anthropic 格式) |
| OpenAI Responses | OpenAI SDK 的 responses.*、Codex CLI | Responses(OpenAI Responses 格式) |
Claude Code、Codex、Cursor 等编程工具的配置见编程工具概览。
三种格式均使用 SciRouter 控制台创建的 API Key(以 sk-sr- 开头)。鉴权、计费与线路选择由平台完成,调用厂商时使用平台自己的凭据;请求中不需要、也不能携带 OpenAI、Anthropic 等厂商的 Key。
1. 创建 API Key
#在控制台的 API Keys 页面新建 Key。在团队工作区新建时须选择一个团队项目,调用扣除团队的配额。
Key 的明文只在创建时显示一次,关闭创建窗口后无法再次查看(见认证与 API Key)。创建后立即复制,存入环境变量或密钥管理工具:
bashexport SCIROUTER_API_KEY="YOUR_API_KEY"2. 选择模型
#在模型中心选择模型,复制其模型 id(格式为 厂商/模型名)。示例中的 YOUR_MODEL_ID 为占位,使用时替换为所选模型的 id。程序中列出该 Key 可调用的模型,使用 GET /models。
3. 发送第一个请求
#bashcurl https://api.scirouter.cn/v1/chat/completions \
-H "Authorization: Bearer $SCIROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "用一句话解释什么是蛋白质二级结构"}]
}'Python(pip install openai):
pythonimport os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["SCIROUTER_API_KEY"],
base_url="https://api.scirouter.cn/v1",
)
response = client.chat.completions.create(
model="YOUR_MODEL_ID",
messages=[{"role": "user", "content": "用一句话解释什么是蛋白质二级结构"}],
)
print(response.choices[0].message.content)响应状态为 200 且 choices[0].message.content 非空,表示接入成功。返回 401、403 或 404 时,按错误码排查。
Playground
#Playground 中可直接调整参数、查看用量,并将当前调用复制为可运行的代码。
Playground 需要登录,不需要 API Key:请求使用登录会话,Key 不出现在网页中。每次运行按实际用量扣除配额。