# SciRouter

> SciRouter 是科研领域下的垂域大模型服务平台，面向科研人员与科研团队。本文档讲其中的模型 API：兼容 OpenAI Chat Completions、OpenAI Responses 与 Anthropic Messages 三种格式，接入多家厂商的科研模型，统一鉴权、计费与调度。

接口兼容 OpenAI 格式，另有 OpenAI Responses 格式的 `/responses` 与 Anthropic Messages 格式的 `/messages`：base URL 是 `https://api.scirouter.cn/v1`，用 `Authorization: Bearer <API Key>`（或 `x-api-key`）认证——三种格式都只认 SciRouter 控制台创建的 Key（`sk-sr-` 开头），OpenAI、Anthropic 等厂商的 Key 不能用。下面每一项都是一份 Markdown；想一次读完全部，用 https://www.scirouter.cn/llms-full.txt。

## 开始

- [快速开始](https://www.scirouter.cn/docs/quickstart.md): 创建 API Key、选择模型并发送第一个请求，确认接入成功。
- [认证与 API Key](https://www.scirouter.cn/docs/authentication.md): API Key 的携带方式、可设置的限制、调用前的检查顺序与预扣规则，以及泄露后的吊销。
- [SDK 与框架](https://www.scirouter.cn/docs/sdks.md): OpenAI 与 Anthropic SDK、常用框架及图形客户端的接入方式，接口清单与重试、超时策略。

## 接入编程工具

- [编程工具概览](https://www.scirouter.cn/docs/coding-tools.md): 编程工具接入平台的通用步骤：各工具的接口格式与地址写法、模型 id、上下文窗口、计费与常见错误。
- [Claude Code](https://www.scirouter.cn/docs/claude-code.md): 在 Claude Code 中使用平台的模型：安装、settings.json 配置、模型映射、上下文窗口与常见报错的处理。
- [Codex](https://www.scirouter.cn/docs/codex.md): 在 Codex 中使用平台的模型：安装、config.toml 配置、环境变量、启动，以及平台对 Codex 请求的处理。
- [OpenCode](https://www.scirouter.cn/docs/opencode.md): 在 OpenCode 中使用平台的模型：安装、opencode.json 中的服务商配置、上下文窗口与模型选择。
- [Kilo CLI](https://www.scirouter.cn/docs/kilo-cli.md): 在 Kilo CLI 中使用平台的模型：安装、kilo.json 中的服务商配置、上下文窗口与模型选择。
- [Kilo Code](https://www.scirouter.cn/docs/kilo-code.md): 在 Kilo Code 插件中使用平台的模型：添加自定义服务商、选择模型、写明上下文窗口。
- [Cursor](https://www.scirouter.cn/docs/cursor.md): 在 Cursor 中使用平台的模型：填写 Key 与地址、添加模型，以及请求经 Cursor 服务器转发带来的限制。
- [CC Switch](https://www.scirouter.cn/docs/cc-switch.md): 在 CC Switch 中添加 SciRouter 供应商，为 Claude Code、Codex、OpenCode 等工具切换到平台的模型。

## 接口

- [对话补全](https://www.scirouter.cn/docs/chat-completions.md): POST /v1/chat/completions 的字段处理、流式响应、思考过程、工具调用、超时与中途断开的计费。
- [Messages（Anthropic 格式）](https://www.scirouter.cn/docs/messages.md): POST /v1/messages 与 count_tokens 的接入、请求转发方式、流式事件、计费与错误格式。
- [Responses（OpenAI Responses 格式）](https://www.scirouter.cn/docs/responses.md): POST /v1/responses 的接入、无状态约束、请求转发方式、流式事件与错误格式。
- [向量](https://www.scirouter.cn/docs/embeddings.md): POST /v1/embeddings 的请求与响应、默认开启的按条缓存，以及批量调用的限制。
- [图片](https://www.scirouter.cn/docs/images.md): POST /v1/images 的生图、改图（含遮罩）、图生图与变体：参数、响应、流式、计费、限额与错误。
- [模型列表](https://www.scirouter.cn/docs/models.md): 列出与查询模型的接口：模型 id 格式、按 API Key 权限过滤的规则、scirouter 扩展字段与计价维度。

## 专题

- [错误码](https://www.scirouter.cn/docs/errors.md): /v1 会返回的每一个错误码：触发条件、是否可重试、处理方式，以及两种格式的错误体。
- [缓存与幂等](https://www.scirouter.cn/docs/caching.md): 提示词缓存与响应缓存的命中条件、请求头与计费，以及用 Idempotency-Key 避免重试重复扣费。
- [可观测性](https://www.scirouter.cn/docs/observability.md): 响应头与扩展字段、控制台日志与用量、调用告警与 webhook，以及 OpenTelemetry 链路导出。
- [多厂商差异](https://www.scirouter.cn/docs/vendors.md): 兼容度标识、各入口协议下的字段生效规则、厂商专有参数、输出上限、用量与计价维度。
- [参数如何被处理](https://www.scirouter.cn/docs/params.md): 参数分类与各入口协议的处理表，模拟、自愈与上下文窗口预检，以及响应头中的处理留痕。
- [MCP 与托管工具](https://www.scirouter.cn/docs/mcp.md): MCP 服务端的接入、工具清单、提示与资源、限额与错误码，以及 /v1 托管工具的请求、响应、计费与数据流向。

## Optional

- [完整文档（单文件）](https://www.scirouter.cn/llms-full.txt): 上面全部接口文档合成一份，开头附接入要点
- [网页端指南：网页 Chat](https://www.scirouter.cn/docs/chat-web.md): 网页 Chat 的回答运行、目标验收、运行中交互、资料与便签、上下文压缩、委派子 agent、科研图与运行代码。
- [网页端指南：技能与工具](https://www.scirouter.cn/docs/skills.md): 技能（SKILL.md）的格式与写法、导入导出、团队与个人的归属、试运行调试，以及 agent 可调用的工具。
- [网页端指南：课题：上手](https://www.scirouter.cn/docs/campaigns.md): 课题的入口、状态与操作、新建与规划、研究与结束条件、任务依赖、修改、扩展版本、花费、权限与删除。
- [网页端指南：课题：证据与报告](https://www.scirouter.cn/docs/campaigns-evidence.md): 课题的记录与证据、观察与实体、引用回源与摘要比对、正式报告与核验码、人审、置信度评估、实验回填、多次运行、分支与合并。
- [网页端指南：课题：多模型协作](https://www.scirouter.cn/docs/campaigns-collab.md): 课题中多个模型的协作：席位与角色预设、任务依赖、消息与提问、留言板与裁定、冲突与推翻、算力池、主持与工作坊。
- [网页端指南：论文研读](https://www.scirouter.cn/docs/papers.md): PDF 与 Word 论文的导入与解析、阅读与笔记、图与量取、概述与精读、问答与翻译、参考文献核对、删除与计费。
- [网页端指南：网盘](https://www.scirouter.cn/docs/drive.md): 网盘的上传、整理、预览与检索、在线编辑、历史版本、分享、回收站、用量与清理、团队空间与暂停。