开发者文档
SciRouter 文档
SciRouter 提供同时兼容 OpenAI Chat Completions、OpenAI Responses 与 Anthropic Messages 三种格式的接口，用于调用多家厂商的科研模型。将现有代码中的 base URL、API Key 与模型 id 替换为 SciRouter 的取值即可接入。
接入信息
- Base URL
- https://api.scirouter.cn/v1
- 认证
- Authorization: Bearer $SCIROUTER_API_KEY
- MCP 端点
- https://api.scirouter.cn/mcp
- SDK
- 支持自定义 base URL 的 OpenAI 或 Anthropic 客户端
接入步骤
开始
4 页创建 API Key、发送第一个请求、接入 SDK 与框架，以及供 AI 编程助手读取的文档。
接入编程工具
8 页Claude Code、Codex、OpenCode、Kilo、Cursor 与 CC Switch 使用平台模型的配置：地址写法、API Key、模型 id 与常见错误。
- 编程工具概览编程工具接入平台的通用步骤：各工具的接口格式与地址写法、模型 id、上下文窗口、计费与常见错误。约 3 分钟
- Claude Code在 Claude Code 中使用平台的模型：安装、settings.json 配置、模型映射、上下文窗口与常见报错的处理。约 6 分钟
- Codex在 Codex 中使用平台的模型：安装、config.toml 配置、环境变量、启动，以及平台对 Codex 请求的处理。约 2 分钟
- OpenCode在 OpenCode 中使用平台的模型：安装、opencode.json 中的服务商配置、上下文窗口与模型选择。约 2 分钟
- Kilo CLI在 Kilo CLI 中使用平台的模型：安装、kilo.json 中的服务商配置、上下文窗口与模型选择。约 2 分钟
- Kilo Code在 Kilo Code 插件中使用平台的模型：添加自定义服务商、选择模型、写明上下文窗口。约 1 分钟
- Cursor在 Cursor 中使用平台的模型：填写 Key 与地址、添加模型，以及请求经 Cursor 服务器转发带来的限制。约 1 分钟
- CC Switch在 CC Switch 中添加 SciRouter 供应商，为 Claude Code、Codex、OpenCode 等工具切换到平台的模型。约 1 分钟
接口
6 页/v1 下的接口：对话补全（OpenAI 格式）、Messages（Anthropic 格式）、Responses（OpenAI Responses 格式）、向量、图片与模型列表，以及各字段的处理方式。
- 对话补全POST /v1/chat/completions 的字段处理、流式响应、思考过程、工具调用、超时与中途断开的计费。约 10 分钟
- Messages（Anthropic 格式）POST /v1/messages 与 count_tokens 的接入、请求转发方式、流式事件、计费与错误格式。约 15 分钟
- Responses（OpenAI Responses 格式）POST /v1/responses 的接入、无状态约束、请求转发方式、流式事件与错误格式。约 10 分钟
- 向量POST /v1/embeddings 的请求与响应、默认开启的按条缓存，以及批量调用的限制。约 3 分钟
- 图片POST /v1/images 的生图、改图（含遮罩）、图生图与变体：参数、响应、流式、计费、限额与错误。约 8 分钟
- 模型列表列出与查询模型的接口：模型 id 格式、按 API Key 权限过滤的规则、scirouter 扩展字段与计价维度。约 7 分钟
专题
6 页上线前需要确定的处理方式：错误与重试、缓存与幂等、可观测性、多厂商差异、参数处理规则、MCP 与托管工具。
- 错误码/v1 会返回的每一个错误码：触发条件、是否可重试、处理方式，以及两种格式的错误体。约 16 分钟
- 缓存与幂等提示词缓存与响应缓存的命中条件、请求头与计费，以及用 Idempotency-Key 避免重试重复扣费。约 10 分钟
- 可观测性响应头与扩展字段、控制台日志与用量、调用告警与 webhook，以及 OpenTelemetry 链路导出。约 23 分钟
- 多厂商差异兼容度标识、各入口协议下的字段生效规则、厂商专有参数、输出上限、用量与计价维度。约 9 分钟
- 参数如何被处理参数分类与各入口协议的处理表，模拟、自愈与上下文窗口预检，以及响应头中的处理留痕。约 11 分钟
- MCP 与托管工具MCP 服务端的接入、工具清单、提示与资源、限额与错误码，以及 /v1 托管工具的请求、响应、计费与数据流向。约 18 分钟
网页端指南
7 页登录网页即可使用的功能：Chat、技能、课题、论文研读与网盘。
- 网页 Chat网页 Chat 的回答运行、目标验收、运行中交互、资料与便签、上下文压缩、委派子 agent、科研图与运行代码。约 7 分钟
- 技能与工具技能（SKILL.md）的格式与写法、导入导出、团队与个人的归属、试运行调试，以及 agent 可调用的工具。约 11 分钟
- 课题：上手课题的入口、状态与操作、新建与规划、研究与结束条件、任务依赖、修改、扩展版本、花费、权限与删除。约 14 分钟
- 课题：证据与报告课题的记录与证据、观察与实体、引用回源与摘要比对、正式报告与核验码、人审、置信度评估、实验回填、多次运行、分支与合并。约 25 分钟
- 课题：多模型协作课题中多个模型的协作：席位与角色预设、任务依赖、消息与提问、留言板与裁定、冲突与推翻、算力池、主持与工作坊。约 8 分钟
- 论文研读PDF 与 Word 论文的导入与解析、阅读与笔记、图与量取、概述与精读、问答与翻译、参考文献核对、删除与计费。约 9 分钟
- 网盘网盘的上传、整理、预览与检索、在线编辑、历史版本、分享、回收站、用量与清理、团队空间与暂停。约 10 分钟
最近更新
- 2026-10-25Messages（Anthropic 格式）anthropic-beta：线路可按配置去掉其中几项；anthropic-version：线路可按配置改成别的值。改了调用方带来的值时记在控制台调用记录的「请求参数」里（scirouter.param_actions，reason 为 header_rule）。
- 2026-10-25可观测性终端用户标识（user，/v1/messages 为 metadata.user_id）超过 512 个字符才截断保存，原来是 64 个字符。
- 2026-10-24可观测性调用记录的保留期从 180 天改为 90 天，到期整行删除；按小时、按天汇总的用量不受影响。
- 2026-10-24编程工具概览新增「接入编程工具」一组：概览与 Claude Code、Codex、OpenCode、Kilo CLI、Kilo Code、Cursor、CC Switch 各一页，写明安装命令、配置文件的路径与完整内容、地址带不带 /v1、模型 id 的映射与常见错误。Messages 的 Claude Code 一节与 Responses 的 Codex CLI 一节移到对应页面；Anthropic SDK 示例的 base URL 直接写成不带 /v1 的地址。
- 2026-10-24认证与 API Key充值余额大于 0 的账户，对话请求的预扣改按「输入估算 + 输出预留」冻结配额（输出预留是 max_tokens 与平台设定值中的较小者），max_tokens 写得大不再多冻结；只有赠送额度的账户照旧按 max_tokens 全额冻结。结束后按实际用量结算，实际超出的部分照扣，配额可能变为负数。Key 月度上限、项目月预算与套餐每日上限仍按全额判断。Anthropic 格式下输入估算超过套餐每分钟上限时，message 以 prompt is too long 开头并带 capability_rejected: prompt_too_long，Claude Code 据此尝试自动压缩对话后重发。
给 AI 助手
将全部接口文档粘贴到 AI 编程助手的对话中，或提供 llms.txt 的地址，由助手按文档生成接入代码。