# SciRouter

> SciRouter 是科研垂域大模型的统一入口：一个与 OpenAI 兼容的 API，接入多家厂商的科研模型，统一计费与调度。

接口与 OpenAI 兼容：base URL 是 `https://api.scirouter.cn/v1`，用 `Authorization: Bearer <API Key>` 认证。下面每一项都是一份 Markdown；想一次读完全部，用 https://www.scirouter.cn/llms-full.txt。

## 开始

- [快速开始](https://www.scirouter.cn/docs/quickstart.md): 五分钟内发出第一个请求。
- [认证与 API Key](https://www.scirouter.cn/docs/authentication.md): 怎么带 Key、一把 Key 能管住什么、泄露了怎么办。
- [SDK 与框架](https://www.scirouter.cn/docs/sdks.md): Python、Node.js、LangChain、LlamaIndex、Vercel AI SDK 的接法，以及我们没有的那些接口。

## 接口

- [对话补全](https://www.scirouter.cn/docs/chat-completions.md): /v1/chat/completions 的每个字段我们怎么处理、流式要注意的四件事、工具调用与中途断开怎么计费。
- [向量](https://www.scirouter.cn/docs/embeddings.md): /v1/embeddings：输入的写法、默认开着的缓存，以及批量向量化的建议。
- [模型列表](https://www.scirouter.cn/docs/models.md): 列出这把 Key 能调用的模型、模型 id 的格式，以及扩展字段的含义。

## 专题

- [错误码](https://www.scirouter.cn/docs/errors.md): 每个错误码该怎么处理，以及哪些值得重试。
- [缓存与幂等](https://www.scirouter.cn/docs/caching.md): 省钱的两层缓存怎么用，以及重试时怎样不被重复扣费。
- [可观测性](https://www.scirouter.cn/docs/observability.md): 每次调用打给了谁、试了几次、慢在哪、离限额还有多远、这个实验花了多少——从响应头、响应体到控制台的日志、用量与导出。
- [多厂商差异](https://www.scirouter.cn/docs/vendors.md): 统一入口已经把协议差异吃掉了；这一页只讲你确实需要知道的那部分。

## Optional

- [完整文档（单文件）](https://www.scirouter.cn/llms-full.txt): 上面全部页面合成一份，开头附接入要点