Amp 接国产模型：Custom URL 配不墨 Router 与模型映射

Amp 的 Model Routing 支持 Custom URL，可把指定模型转到不墨 Router。附 CLI 命令、模型映射写法和需要 Amp 账号等限制。

可以。Amp 的 Model Routing 支持 Custom URL 连接，所有档位可用：把 Base URL 设成 https://router.bumo.cc/v1，格式选 chat-completions，再用模型映射指定哪些模型走 Router。但 Amp 必须先登录账号，没有映射到的模型仍由 Amp 提供并扣 Amp 额度。

核验日期：2026-10-30。本文没有跑通端到端。 Amp CLI 未登录时 amp config model-providers list 直接提示要 amp login，我们没有用账号测试。命令参数来自本机 CLI（0.0.1793347237-gb47dfa）的 --help，其余依据官方 Model Routing 文档。Router 侧用同样的 Bearer 鉴权和 /chat/completions 路径，发带 tools 的流式请求，确认返回了 tool_calls 分片。

先准备一个 Router Key

登录不墨 Router，在 API Key 页面创建一个 Key，并给钱包充值。

用 CLI 添加连接

npm install -g @ampcode/cli
amp login

printf '%s' 'sk-...' | amp config model-providers add-router custom-url \
  --name bumo-router \
  --api-format chat-completions \
  --base-url https://router.bumo.cc/v1 \
  --api-key-file - \
  --model-mapping 'moonshotai/kimi-k3 -> kimi/kimi-k3' \
  --personal \
  --active

旧包名 @sourcegraph/amp 已改名为 @ampcode/cli，老教程里的安装命令要换掉。

也可以走网页：Settings → Model Routing → Add → Custom URL，填同样的内容。

模型映射怎么写

映射决定两件事：这条连接接管 Amp 里的哪些模型，以及发给 Router 的模型 ID 是什么。

moonshotai/kimi-k3 -> kimi/kimi-k3

箭头左边是 Amp 里的模型 ID，右边是 Router 的模型 ID。两边写法经常不同，比如 Router 这边是 kimi/kimi-k3，所以要写箭头。

左边的 ID 以你账号里 Amp 显示的为准，本文的例子取自官方文档的 moonshotai/kimi-k3 写法。Router 这边的 ID 查 https://router.bumo.cc/v1/models。

映射留空时默认接管「供应商支持的全部模型」。建议明确写出要走 Router 的模型，排查时一眼能看出谁走了哪条线路。

检查是否生效

amp config model-providers list
amp config model-providers check-access --provider-model moonshotai/kimi-k3

check-access 会跑一次很短的推理，并报告这个模型由哪条连接提供。看到 bumo-router 才算走通。

如果模型没出现在 Mode Dial 里，通常是 Amp 不知道它的 token 上限。Amp 从接口的 /models 或 models.dev 读取这个信息，读不到就要到网页设置的 Model Metadata Overrides 手动填，CLI 不能设置这一项。填好后在 Settings → Mode Dial → Tune Modes 把角色固定到这个模型。

使用前要知道的

必须有 Amp 账号：这和 Droid、Copilot CLI 的免登录 BYOK 不一样。
请求从 Amp 服务器发出：官方文档提到，如果接口限制来源 IP，需要放行 Amp 的服务器地址。Key 也要交给 Amp 保存。介意的话选能在本地跑的客户端。
费用分两边算：走你自己连接的模型由 Router 计费，没有连接提供的模型由 Amp 提供并扣 Amp 额度。企业版可能对经连接提供的 token 另收 Amp 费用。
优先级：Amp 先试个人连接（从上到下），再试工作区连接，最后才是 Amp 自己。企业管理员可以禁止个人连接。

常见问题

现象	先查
`Invalid or missing API key. Run 'amp login'`	这是 Amp 账号没登录，不是 Router Key 的问题
`check-access` 显示不是 `bumo-router`	映射左边的 ID 是否与 Amp 的一致，连接是否 active，优先级是否靠前
请求 404	Base URL 停在 `/v1`，Amp 会自己追加 `/chat/completions`
Mode Dial 里找不到模型	去 Model Metadata Overrides 补 token 上限