Skip to main content
Perplexity

Search documentation

Type to search this documentation.

Retrieve Model

GET

/

router

/

v1

/

models

/

Retrieve Model

curl --request GET \
  --url https://api.perplexity.ai/router/v1/models/{model} \
  --header 'Authorization: Bearer <token>'
title="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
  }
}
title="404"
{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "type": "<string>"
  }
}

Authorization

string

header

required

Your Perplexity API key.

model

string

required

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

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

Was this page helpful?

⌘I

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu