文档

Amp

Amp 在服务器端路由模型，因此无需在本机设置基础 URL 变量——你只需在 Model Routing 中添加 Custom URL 连接，之后由 Amp 云端调用该端点。此功能仅包含在付费层级中，首先应检查账户层级。

在 Amp 的 Model Routing 中添加 Custom URL 连接 — API format 设为 chat-completions，基础 URL 为 https://api.kunavo.com/v1，密钥作为 bearer token — 在支持该选项的档位中，将映射模型切换到一个密钥。

Settings → Model Routing → Add → Custom URL

Connection type    Custom URL            (Model Routing → Add)
API format         chat-completions      OpenAI Chat Completions API, the default
Base URL           https://api.kunavo.com/v1
Key                sk-kn-...             sent as Authorization: Bearer <key>
Headers            —                     nothing extra is needed
Query Parameters   —                     nothing extra is needed
Model mapping      anthropic/claude-opus-4-6 -> claude-opus-4-6
                   anthropic/claude-fable-5  -> claude-fable-5
                   openai/gpt-5.6-sol        -> gpt-5-6-sol

首先检查你的 Amp 账户等级。 Amp 的 Model Routing 页面在 2026-09-21 写道：“AI 模型路由器和网关目前处于实验阶段，并仅向 Megawatt、Gigawatt 和 Enterprise 客户开放早期访问。我们很快会向所有人推出。”自定义 URL 连接属于这一类别，因此 Hobby 账户的 Add 菜单中不会提供该选项。Amp 尚未公布推出日期，本页面也不会对此进行预测。

Kunavo 尚未使用此端点运行过 Amp。上面的每个字段都摘自 Amp 自己的文档，并非来自任何人在此完成的会话——该功能仅对付费 Amp 层级开放。请将此内容视为对 Amp 规格的转述，并通过 检查访问权限 确认其是否可用。

chat-completions 会在基础 URL 中保留 /v1 后缀，因为 Amp 只会附加路由。该页面给出的示例足以说明这一点：“基础 URL 为 https://api.example.com/v1 且使用 chat-completions 时，请求会发送到 https://api.example.com/v1/chat/completions。”页面还补充说，末尾已带有 /v1 的基础 URL“会被接受，且不会重复添加”，并且连接表单会在你输入时显示请求 URL — 因此保存前可以查看拼接后的完整 URL。

Amp 的 Dictation 和 Realtime Voice 系统模型属于语音功能，而 Kunavo 不提供语音转文本模型或文本转语音模型。这里的 Custom URL 连接无法为这两项功能提供支持；请将这些条目留给 Amp。

还没有密钥？创建 Kunavo 账户，创建一个密钥（以 sk-kn- 开头），并充值 $10 起——调用费用从该余额中扣除，失败的调用不会收费。随后，控制台会打开 Amp 设置页面。

分步操作

在 /app/keys 创建密钥并复制——它只会显示一次。
在个人设置中打开 Model Routing（工作区管理员可使用 Workspace Model Routing 与所有成员共享一个连接），打开 Add 菜单，然后选择 Custom URL。
将 API 格式设为 chat-completions，将 https://api.kunavo.com/v1 粘贴为基础 URL，并将你的 sk-kn- 密钥作为密钥。Amp 会在所有格式中将其作为 Authorization: Bearer <key> 发送，这是 Kunavo 用于身份验证的请求头，因此 Headers 和 Query Parameters 保持为空。
编写模型映射，每行一个模式。左侧是 Amp 的规范模型 ID，-> 后的右侧是 Kunavo 接收的 ID——两者的写法不同（Amp 使用 openai/gpt-5.6-sol，Kunavo 接受 gpt-5-6-sol），因此这里不能省略箭头。使用 Models 选择器插入规范 ID，不要凭记忆输入。
点击 Check Access。如果映射范围较广，Amp 会列出端点的模型；如果映射恰好指定一个模型，Amp 会发送一个 token 的请求。然后确认连接列表下方的路由图显示 Kunavo 正在提供你映射的模型，而所有未映射的模型仍显示由 Amp 提供。

已于 2026年9月21日对照 Amp 的模型路由文档检查。第三方设置会发生变化；如果这里的字段名称不再与你看到的内容一致，应以该页面为准，而不是本页。

这是简要版本。完整教程——包括模型选择、真实会话成本和失败模式——见 Amp 本身的费用，以及连接会或不会改变账单的哪些部分。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON，则相同的基础 URL 和密钥可以在 Amp 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models，包含价格的目录见模型页面。费率单位为每 1M token 的美元，格式为输入 / 输出。

模型 ID	Kunavo 输入 / 输出	它在 Amp 中的位置
`gpt-5-6-sol`	$2.00 / $12.00	Medium 模式的主代理和 Puck——Amp 的默认工作模型
`gpt-6-astra`	$4.00 / $20.00	High 模式的主代理，以及大多数模式中的 Oracle 子代理
`claude-fable-5-1`	$7.00 / $35.00	Ultra 模式的主代理，专为棘手的开放式任务保留
`gpt-5-6-terra`	$0.70 / $4.20	Search 子代理——代码库检索，调用量是主要影响因素
`claude-haiku-4-5`	$0.70 / $3.50	View Media，Amp 用于处理图像、PDF 和视频的模型——Claude 能读取图像，不能读取视频

计费方式是从预付余额中按 token 扣费，无月费——参见计费。对于重复上下文——这正是编辑器或聊天客户端发送内容的大部分——提示缓存对账单的影响大于模型选择。

连接不会改变哪些费用

模型路由只会改变谁为你的 token 计费，不会影响其他费用。Amp 的 orb 算力按分钟单独计量，因此添加连接不会改变这一项；无论模型如何路由，网页搜索等非模型工具仍会消耗 Amp 额度。解锁 Custom URL 选项的 Amp 订阅本身也是固定费用，在第一个 token 产生之前就会开始计费。

Amp 默认运行的两个模型未列在上表中，因为 Kunavo 不提供它们：Low 模式背后的 GLM 模型，以及 Read Thread 子代理。连接无法按当前配置复现 Amp 最便宜的通道，因此映射为 */* 会悄然让这两个模型继续使用 Amp。这是正确结果，不是配置错误——Amp 自身的规则是，任何连接都不提供的模型均由 Amp 提供。

常见问题

Amp 能否使用自定义 API 端点？

可以，通过模型路由中的 Custom URL 连接实现，但并非所有套餐都支持。Amp 的模型路由文档称，AI 模型路由器和网关（Custom URL 所属的类别）目前处于实验阶段，仅向 Megawatt、Gigawatt 和 Enterprise 客户开放早期体验；Amp 还表示很快会向所有用户推出，但没有说明日期。截至 2026 年 9 月 21 日，情况如此。Hobby 账户的 Add 菜单完全没有这个选项，因此首先应检查套餐，而不是基础 URL。

Amp 的基础 URL 末尾需要加 /v1 吗？

这取决于你选择的 API 格式，这也是这个字段经常被误读的原因。使用 chat-completions 时，Amp 只会追加 /chat/completions，因此基础 URL 必须是 /v1 根路径——Amp 自己的文档示例会将 https://api.example.com/v1 转换为 https://api.example.com/v1/chat/completions。使用 anthropic-messages 时，Amp 会改为追加 /v1/messages，因此此时只填源站地址即可。Amp 还说明，末尾已带 /v1 的基础 URL 可以接受，且不会重复追加；连接表单会在你输入时显示拼接后的请求 URL，因此保存前可以核对。

Amp 会将自定义端点的 API 密钥存在哪里？

存储在 Amp 的服务器上，而不是你的设备上。Amp 从自己的云端代理推理，因此需要在账户设置的模型路由中配置 Custom URL 连接，而不是写入本地配置文件或环境变量；你指定的端点必须能从 Amp 的基础设施访问。Amp 会在其三种 API 格式中都通过 Authorization: Bearer 请求头发送凭据。Amp 发布的 CLI 设置参考中没有基础 URL 设置或 API 密钥设置，从客户端一侧看也是同样的情况。

添加连接后，为什么 Amp 仍会使用自己的模型？

因为连接只会提供其映射中包含的模型，其他模型仍由 Amp 自行提供。依次检查三项：连接是否已启用；它在优先级列表中的位置——先是个人连接，然后是工作区连接，最后是 Amp，优先级 0 会先尝试；以及模型映射是否确实匹配当前模式所运行的模型。连接列表下方的路由图会显示每个模型由哪个连接提供；运行 amp config model-providers check-access --provider-model 会执行一次简短推理，并报告实际提供该模型的连接。

Kunavo 是否已针对其端点测试过 Amp？

没有。Kunavo 尚未在运行时测试 Amp；本页面是根据截至 2026 年 9 月 21 日查阅的 Amp 自有模型路由文档整理而成，并非已完成测试的报告。Custom URL 功能仅对付费 Amp 套餐开放，因此此处的字段是根据 Amp 发布的规范核对的，而非通过运行中的客户端验证。Amp 的 Check Access 按钮会使用凭据向服务提供商验证，这是权威的测试方式；如果本页面上的字段名称与 Amp 当前显示的不一致，应以 Amp 页面为准。