# Router API

::::card-grid
:::card{title="Create Chat Completion" href="/guides/router-api-2-gateway-chat-completions-post"}
Send a conversation to any Router model using the OpenAI Chat Completions schema. Set stream: true to receive server-sent events; add stream\_options: {"include\_usage": true} to get token usage in the final chunk.
:::

:::card{title="Create Response" href="/guides/router-api-2-gateway-responses-post"}
Generate a model response using the OpenAI Responses schema. Set stream: true to receive typed server-sent events followed by data: \[DONE].
:::

:::card{title="Create Message" href="/guides/router-api-2-gateway-messages-post"}
Send a conversation to any Router model using the Anthropic Messages schema. Set stream: true to receive server-sent events. Authenticate with your Perplexity API key — both Authorization: Bearer and the Anthropic SDK’s default x-api-key header are accepted.
:::

:::card{title="List Models" href="/guides/router-api-2-gateway-models-get"}
List the models available through the Router, sorted by id. Each model includes its base token prices in pricing (USD per 1M tokens).
:::

:::card{title="Retrieve Model" href="/guides/router-api-2-gateway-model-get"}
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.
:::
::::

## Related pages

- [Admin & Management](./admin-management-index.md)
- [Agent API](./agent-api-2-index.md)
- [Agent API](./agent-api-index.md)
- [Analytics API](./analytics-api-index.md)
- [Authentication](./authentication-index.md)
- [Changelog](../changelog.md)
- [Cookbook](./cookbook-2-index.md)
- [Embeddings API](./embeddings-api-2-index.md)
- [Embeddings API](./embeddings-api-index.md)
- [Getting Started](./getting-started-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.