Models API

List and query all available models on the kineticRouter platform. The returned data follows the OpenRouter standard and includes complete model metadata: architecture, pricing, supported parameters, and more.

Like every kineticRouter API, the Models API requires a kineticRouter API Key. Send it as Authorization: Bearer <your KINETICROUTER_API_KEY>. For detailed field descriptions, see Model Catalog — Models API Standard.

List All Models


GET https://api.kineticrouter.com/v1/models

Request Examples

cURL

Terminal


curl https://api.kineticrouter.com/v1/models \
  -H "Authorization: Bearer $KINETICROUTER_API_KEY"

Python

models.py


import os
import requests
 
resp = requests.get(
    "https://api.kineticrouter.com/v1/models",
    headers={"Authorization": f"Bearer {os.environ['KINETICROUTER_API_KEY']}"},
)
for model in resp.json()["data"]:
    print(model["id"])

TypeScript

models.ts


const resp = await fetch('https://api.kineticrouter.com/v1/models', {
  headers: { Authorization: 'Bearer ' + process.env.KINETICROUTER_API_KEY }
})
const { data } = await resp.json()
 
for (const model of data) {
  console.log(model.id)
}

Response Format

Planned example

The Anthropic-native route is planned and its configuration is shown only as a reference. This example is intentionally not copyable in its current display state.

Response Fields

Field	Type	Description
`id`	string	Model identifier, e.g. `"anthropic/claude-sonnet-4.6"`
`canonical_slug`	string	Permanent identifier, never changes
`name`	string	Model display name
`created`	number	Time added (Unix timestamp)
`description`	string	Model capability description
`context_length`	number	Maximum context window (tokens)
`architecture`	object	Input/output modalities and tokenizer info
`pricing`	object	Pricing (USD/token)
`top_provider`	object	Provider config (context limit, max output, etc.)
`supported_parameters`	string[]	Supported API parameters

Filter Models by Provider


GET https://api.kineticrouter.com/v1/models/{provider}

Returns only models from the specified provider.

Path Parameters

Parameter	Type	Description
`provider`	string	Provider identifier, e.g. `anthropic`, `openai`, `google`, `bailian`, `volcengine`

Request Examples

Terminal


# List all Anthropic models
curl https://api.kineticrouter.com/v1/models/anthropic \
  -H "Authorization: Bearer $KINETICROUTER_API_KEY"
 
# List all OpenAI models
curl https://api.kineticrouter.com/v1/models/openai \
  -H "Authorization: Bearer $KINETICROUTER_API_KEY"

Response Format

The response format is the same as listing all models, with the data array containing only models from the specified provider.

Get Model Details


GET https://api.kineticrouter.com/v1/models/{provider}/{model_id}

Path Parameters

Parameter	Type	Description
`provider`	string	Provider identifier, e.g. `anthropic`
`model_id`	string	Model name, e.g. `claude-sonnet-4.6`

Request Example

Terminal

Planned example

The Anthropic-native route is planned and its configuration is shown only as a reference. This example is intentionally not copyable in its current display state.

Response Format

Returns a single Model object with the same structure as objects in the list endpoint.