模型定价

当你需要价格，而不只是模型可见性时，用这条路由。 /v1/models/pricing 返回某个模型的权威价格。如果同一个模型可能路由到多条不同映射，PipeLLM 只会在这些映射能收敛到一个权威价格时直接返回结果；否则你必须通过 provider 或 platform_id 继续收窄。

端点

GET https://api.pipellm.ai/v1/models/pricing

查询参数

参数	必填	说明
`model`	是	要查询价格的模型 ID
`provider`	否	用 provider 收窄匹配映射
`platform_id`	否	用平台 ID 直接定位具体映射

说明

这条路由只支持 GET
model 是必填参数
如果多条匹配映射的价格不同，而你又没有继续收窄，请求会返回 409 Conflict
如果多条匹配映射的价格完全一致，这条路由会直接返回这个权威价格，不强制要求 selector

请求示例

cURL
cURL（带 selector）

curl "https://api.pipellm.ai/v1/models/pricing?model=gpt-5" \
  -H "Authorization: Bearer $PIPELLM_API_KEY"

curl "https://api.pipellm.ai/v1/models/pricing?model=gpt-5&provider=openai" \
  -H "Authorization: Bearer $PIPELLM_API_KEY"

响应格式

{
  "object": "pricing",
  "data": {
    "id": "gpt-5",
    "display_name": "Gpt 5",
    "type_target": "openai",
    "provider": "openai",
    "pricing": {
      "kind": "token",
      "text": {
        "prompt": "0.000003",
        "completion": "0.000015",
        "internal_reasoning": "0.000015"
      },
      "cache": {
        "read": "0.000001",
        "write": "0.00000375",
        "write_1h": "0.0000075"
      },
      "tiers": {
        "over_200k": {
          "text": {
            "prompt": "0.0000055",
            "completion": "0.000022",
            "internal_reasoning": "0.000022"
          }
        }
      }
    }
  }
}

响应字段

字段	类型	说明
`object`	string	固定值 `"pricing"`
`data.id`	string	API 请求里使用的模型 ID
`data.display_name`	string	基于模型 ID 自动生成的人类可读名称
`data.type_target`	string	这条模型对外暴露的协议族
`data.provider`	string	当请求已经定位到单一映射，或显式指定了 provider 时返回
`data.platform_id`	integer	当请求已经定位到单一映射时返回的平台 ID
`data.pricing`	object	权威价格对象

什么情况下会返回歧义

当以下条件同时满足时，PipeLLM 会返回 409 Conflict：

同一个 model 匹配到多条可见映射
这些映射的价格并不一致
你又没有通过 provider 或 platform_id 继续收窄

这是刻意设计的行为。只要路由层真实可能选到不同价格的映射，API 就不会伪造一个 “代表价格”。

总览

使用 API

OpenAI 兼容

Anthropic

Gemini

端点

查询参数

说明

请求示例

响应格式

响应字段

什么情况下会返回歧义

​端点

​查询参数

​说明

​请求示例

​响应格式

​响应字段

​什么情况下会返回歧义

端点

查询参数

说明

请求示例

响应格式

响应字段

什么情况下会返回歧义