# 快速开始

> 创建 API Key、选择模型并发送第一个请求，确认接入成功。

来源：https://www.scirouter.cn/docs/quickstart · 更新于 2026-10-24

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 格式）](https://www.scirouter.cn/docs/messages) |
| OpenAI Responses | OpenAI SDK 的 `responses.*`、Codex CLI | [Responses（OpenAI Responses 格式）](https://www.scirouter.cn/docs/responses) |

Claude Code、Codex、Cursor 等编程工具的配置见[编程工具概览](https://www.scirouter.cn/docs/coding-tools)。

三种格式均使用 SciRouter 控制台创建的 API Key（以 `sk-sr-` 开头）。鉴权、计费与线路选择由平台完成，调用厂商时使用平台自己的凭据；请求中不需要、也不能携带 OpenAI、Anthropic 等厂商的 Key。

## 1. 创建 API Key

在控制台的 [API Keys 页面](https://www.scirouter.cn/console/keys)新建 Key。在团队工作区新建时须选择一个团队项目，调用扣除团队的配额。

Key 的明文只在创建时显示一次，关闭创建窗口后无法再次查看（见[认证与 API Key](https://www.scirouter.cn/docs/authentication)）。创建后立即复制，存入环境变量或密钥管理工具：

```bash
export SCIROUTER_API_KEY="YOUR_API_KEY"
```

## 2. 选择模型

在[模型中心](https://www.scirouter.cn/models)选择模型，复制其模型 id（格式为 `厂商/模型名`）。示例中的 `YOUR_MODEL_ID` 为占位，使用时替换为所选模型的 id。程序中列出该 Key 可调用的模型，使用 [`GET /models`](https://www.scirouter.cn/docs/models)。

## 3. 发送第一个请求

```bash
curl 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`）：

```python
import 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 时，按[错误码](https://www.scirouter.cn/docs/errors)排查。

## Playground

[Playground](https://www.scirouter.cn/playground) 中可直接调整参数、查看用量，并将当前调用复制为可运行的代码。

Playground 需要登录，不需要 API Key：请求使用登录会话，Key 不出现在网页中。每次运行按实际用量扣除配额。

## 相关文档

- LangChain、LlamaIndex、Vercel AI SDK 与 Node.js：[SDK 与框架](https://www.scirouter.cn/docs/sdks)
- 流式、工具调用、思考过程与 `max_tokens` 超限的处理：[对话补全](https://www.scirouter.cn/docs/chat-completions)
- 错误处理：[错误码](https://www.scirouter.cn/docs/errors)
- 单次调用路由到的线路与扣费：[可观测性](https://www.scirouter.cn/docs/observability)
- 整份文档的一键复制，供 AI 编程助手生成接入代码：[给 AI 助手](https://www.scirouter.cn/docs/llms)