Get Model Pricing

Use this route when you need pricing, not just catalog visibility. /v1/models/pricing returns authoritative pricing for a specific model. When a model can route across multiple mappings, PipeLLM only returns a price if the matching mappings resolve to one authoritative price. Otherwise, you must disambiguate with provider or platform_id.

Endpoint

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

Query Parameters

Parameter	Required	Description
`model`	yes	Model ID to price
`provider`	no	Provider name to narrow the matching mappings
`platform_id`	no	Platform ID to resolve a specific mapping

Notes

This route only supports GET.
model is required.
If multiple matching mappings produce different prices and you do not narrow the request, the route returns 409 Conflict.
If the matching mappings all produce the same price, the route returns that authoritative price without requiring a selector.

Example Requests

cURL
cURL (disambiguated)

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"

Response Format

{
  "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"
          }
        }
      }
    }
  }
}

Response Fields

Field	Type	Description
`object`	string	Always `"pricing"`
`data.id`	string	Model ID used in API requests
`data.display_name`	string	Human-readable label generated from the model ID
`data.type_target`	string	Target protocol family for routing
`data.provider`	string	Resolved provider when the request identifies a single mapping or explicit provider selection
`data.platform_id`	integer	Resolved platform ID when the request identifies a single mapping
`data.pricing`	object	Authoritative pricing object

Ambiguous Pricing

PipeLLM returns 409 Conflict when:

the same model matches multiple visible mappings
those mappings have different prices
and you did not narrow the request with provider or platform_id

That behavior is intentional. The API does not fabricate a representative price when the routing layer can legitimately choose different-priced mappings.

Overview

Using the API

OpenAI Compatible

Anthropic

Gemini

Endpoint

Query Parameters

Notes

Example Requests

Response Format

Response Fields

Ambiguous Pricing

​Endpoint

​Query Parameters

​Notes

​Example Requests

​Response Format

​Response Fields

​Ambiguous Pricing

Endpoint

Query Parameters

Notes

Example Requests

Response Format

Response Fields

Ambiguous Pricing