接入文档

一套域名、一把令牌，OpenAI 与 Anthropic 两种协议都能用。本页重点讲 magpie 的接入方式。

1. 端点与令牌

用途	Base URL
OpenAI Chat / Responses	`https://api.captainmus.top/v1`
Anthropic Messages	`https://api.captainmus.top`

令牌在控制台 → 令牌管理创建：48 位字符串，没有 sk- 前缀，原样粘贴即可。

分组决定能调哪些模型、按什么倍率计费：

分组	倍率	可用范围
`default`	1.0×	全部模型
`gemini`	0.1×	Gemini 系列（最便宜的用法）

2. magpie 接入（推荐）

Windows / macOS / Linux magpie 是一个本地网关：Claude Code、Codex、Gemini CLI、OpenCode 等 Agent 都指向它，由它统一把请求转发到各家模型。你只要在里面加一条本站在内的 provider，Agent 侧的模型下拉里就会出现本站的模型。

2.1 安装

从 usemagpie.ai 下载对应平台安装包。安装后它会驻留在菜单栏/托盘。

2.2 图形界面添加本站

打开 magpie 面板 → Providers（提供商） → 添加提供商。
类型选 自定义 / Custom，名称填 captainmus。
Base URL 填 https://api.captainmus.top/v1（必须带 /v1）。
API Key 粘贴你的 48 位令牌。
保存后会从 /v1/models 自动拉取模型列表；勾选要暴露的模型。

2.3 命令行添加（等价，适合脚本化）

# 添加本站为自定义 provider
magpie provider add captainmus url=https://api.captainmus.top/v1 key=<你的令牌>

# 拉取/刷新模型列表
magpie provider models captainmus

# 发一个最小请求自检（每个 API 各一次，带延迟）
magpie provider test captainmus

# 看看 Agent 能选到什么
magpie models

2.4 给 Agent 指定模型

# Claude Code 用本站的 Gemini
magpie claude captainmus/gemini-3.8-flash-low

# Codex 用本站的 DeepSeek
magpie codex captainmus/deepseek-v4.1-flash

# 只查看当前每个 Agent 绑了什么
magpie providers

也可以在 magpie 面板里逐个 Agent 点选模型，效果一样；它会只改对应配置文件里的那一个键，注释和格式都会保留。

2.5 它是怎么工作的

magpie 在本机起一个网关（默认 http://127.0.0.1:3425/v1），同时讲 OpenAI Chat、OpenAI Responses 和 Anthropic Messages 三种协议，Agent 只认识这个本地地址，厂商的 Key 和 URL 都不落在 Agent 配置里。所以换站、换模型、换账号都不需要重配 Agent。

3. Cherry Studio / CC Switch

Cherry Studio：新建服务商，协议选 Anthropic，Base URL 填 https://api.captainmus.top（不带 /v1），Key 填令牌，然后同步模型。

CC Switch：添加供应商时选 OpenAI 兼容，Base URL 填 https://api.captainmus.top/v1。

4. 模型与计费

实时价格见模型广场。当前在线模型：

模型	端点	备注
`gemini-3.8-flash-high` / `-medium` / `-low` / `-tiered`	anthropic, openai	本站主力，gemini 分组 0.1×
`deepseek-v4.1-flash`	openai	Command Code 线路
`qwen3.8-flash`	openai	Command Code 线路
`zai-org/GLM-5.3`	openai	Command Code 线路
`mimo-v2.6-pro`	openai	Command Code 线路
`muse-spark-1.3-contributor`	openai	Command Code 线路

Command Code 线路提示：上游凭据过期时这些模型会返回 401，需要管理员在云端 cmdc 面板重新登录一次；Gemini 线路不受影响。

5. 常见问题

404 Not Found

Base URL 少了 /v1（OpenAI 协议），或者多了 /v1（Anthropic 协议）。按上面第 1 节填。

401 Unauthorized

令牌不对、被禁用或已过期；也可能是分组选错（比如 gemini 分组调不到 Command Code 的模型）。

模型列表是空的

magpie 里执行 magpie provider models captainmus 重新拉取；控制台里确认令牌分组可用的模型。

流式输出正常但用量为 0

极少数转换路径下上游不回 usage，属于已知情况，不影响使用。