线路与路由

同一个模型可能由多条线路提供，价格和速度各不相同。每条线路有固定的 ID（如 fast、cheap），各线路的价格在 模型页 上能看到。

默认行为

什么都不设置时，按平台推荐顺序尝试。一条线路失败，自动换下一条。

单次指定：route 参数

在请求体里加 route，只对这一次请求生效：

"route": "fast"                                       只用这一条
"route": ["fast", "cheap"]                            只用这几条，按顺序
"route": { "sort": "price" }                          按价格从低到高
"route": { "sort": "price", "max_price_usd": 0.05 }   同上，且不用超过 $0.05 的线路
"route": { "routes": ["fast", "cheap"], "max_price_usd": 0.05 }

给密钥设默认

在 API 密钥 页打开某个密钥的「线路与限额」，可以设置：

• 排序方式：推荐顺序、价格从低到高，或自定义顺序。
• 不用的线路：这个密钥永远不走这些线路。
• 例外规则：满足条件的请求（某些模型、某个参数，比如 resolution 为 4K）只走指定的线路。按顺序取第一条匹配的规则。
• 单次最高价：超过这个价格的线路不用。

优先级从高到低：请求里的 route → 密钥上第一条匹配的例外规则 → 密钥的排序方式和不用的线路 → 平台推荐顺序。

换线规则

• 只在你允许的线路之间切换，绝不会走到列表外的线路。
• 排序只决定先试哪条，不会替你做别的决定。
• 某条线路不支持这次的参数（比如不支持 4K），这条线路直接跳过。
• 换线后按新线路的价格计费，见 计费与退款。

相关错误

• route_not_offered：指定的线路不提供这个模型。
• no_route_selected：你的设置把这个模型的线路都排除了。
• price_above_max：所选线路都超过了最高价。
• unsupported_parameters：所选线路都不支持这组参数。