Skip to main content
当你需要价格,而不只是模型可见性时,用这条路由。 /v1/models/pricing 返回某个模型的单个权威价格对象,不会列出全部渠道的价格。 如果同一个模型可能路由到多个渠道,PipeLLM 只会在这些渠道能收敛到一个权威 价格时直接返回结果;否则可以通过 provider 指定渠道。

端点

查询参数

说明

  • 这条路由只支持 GET
  • model 是必填参数
  • 只有一个可见渠道时,直接返回该渠道的价格
  • 多个可见渠道的有效价格完全一致时,返回一份统一价格
  • 多个可见渠道的有效价格不一致时,请求会返回 409 Conflict;可以通过 provider 指定渠道

请求示例

响应格式

响应字段

什么情况下会返回歧义

当以下条件同时满足时,PipeLLM 会返回 409 Conflict
  • 同一个 model 匹配到多条可见映射
  • 这些映射的价格并不一致
  • 你又没有通过 provider 指定渠道
这是刻意设计的行为。只要路由层真实可能选到不同价格的映射,API 就不会伪造一个 “代表价格”。