线路
同一个模型,Rabah 可能通过几条不同的线路提供。不同线路的价格、稳定性和速度可能不同。
你不用为每条线路单独申请密钥:一个密钥可以使用你能用的所有线路,在请求的模型名里决定走哪一条。
请求里只写模型名,比如 claude-sonnet-4-6,就走这个模型的默认线路。模型广场里标着”默认”的就是它。
默认线路由平台设定,不一定是最便宜的那条。在乎价格的话,可以指定线路。
默认线路暂时不可用时
Section titled “默认线路暂时不可用时”只写模型名时,如果默认线路当前没有可用的账号(比如正在限流或维护),请求会自动改走下一条可用的线路,不会直接失败。
这时价格按实际使用的线路计算,可能和默认线路不同。每次请求的费用可以在 Hub 的 使用记录 里查看,鼠标移到费用上还能看到单价。想确保始终按某条线路的价格计费,请指定线路。
模型名后面加上 :线路代号,就固定走这条线路:
claude-sonnet-4-6:pro- 线路代号在模型广场展开模型后可以看到,点那一行的”复制模型名”就会复制完整的写法。
- 调用
GET /v1/models时,有多条线路的模型,会额外列出每条线路的模型名:线路代号。 - 代号不区分大小写,
:PRO和:pro一样。
指定了线路的请求不会自动换线路。这条线路暂时不可用时,请求会直接报错,方便你确定每次都是按这条线路的价格计费。
除了所有人都能用的公开线路,平台还可以给特定用户开通专属线路,在模型广场里标着”专属”。
- 专属线路只有登录后才能在模型广场看到,而且只对开通了的账号显示。
- 用法和公开线路一样:只写模型名时可能走到它,也可以用
模型名:线路代号指定。
限制密钥能用哪些线路
Section titled “限制密钥能用哪些线路”创建或编辑密钥时,线路与模型 选项可以限制这个密钥的使用范围:
- 全部线路和模型(默认):你能用的所有线路和模型,以后新增的也包括在内。
- 指定线路和模型:只能用勾选的。整条线路勾选时,这条线路以后新增的模型也能用。
只写模型名时,被限制掉的线路会被跳过,自动走下一条允许的线路。
| 状态码 | 报错信息 | 原因 |
|---|---|---|
| 404 | Model <模型名> is not available | 没有任何线路提供这个模型;或者线路代号写错了;或者指定了你没开通的专属线路。检查模型名是否和模型广场里的完全一致。 |
| 403 | Model <模型名> is not allowed for this API key | 模型存在,但这个密钥的”线路与模型”设置不允许用它。到 Hub 编辑密钥即可。 |
| 503 | No available accounts 或 Service temporarily unavailable | 线路的账号暂时都忙或受限。只写模型名的请求会尽量避开这种线路,但仍可能遇到;指定了线路的请求更容易遇到。稍后重试,或者换一条线路。 |