Retrieve Model

Retrieve one model by id, including its base token prices. Model ids contain a / (for example perplexity/kimi-k3); pass the full id in the path.

GET /router/v1/models/{model}

Retrieve Model

cURL

curl --request GET \
  --url https://api.perplexity.ai/router/v1/models/{model} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "<string>",
  "object": "<string>",
  "created": 123,
  "owned_by": "<string>",
  "pricing": {
    "input": 123,
    "output": 123,
    "unit": "usd_per_1m_tokens",
    "cache_write": 123,
    "cache_read": 123
  }
}

Model ids contain a / — pass the full id in the path, for example GET /router/v1/models/perplexity/kimi-k3.

Authorizations

Authorization · string · header · required

Your Perplexity API key.

Path Parameters

model · string · required

The model id, e.g. perplexity/kimi-k3.

Response

200

application/json

The model.

id · string · required

Public model slug, e.g. perplexity/kimi-k3.

object · string · required

Always model.

created · integer<int64> · required

owned_by · string · required

Provider prefix of the slug, e.g. perplexity.

pricing · object · required

Base token prices in USD per 1M tokens. Every field is a price; cache_read is the effective cached-input price.

Show child attributes