List selectable models plus per-role runtime model defaults

Selectable models + the code-default model each runtime role falls back to.

The role defaults mirror the runtime constants (single-sourced via src.runtime.model_defaults.ROLE_DEFAULTS, which imports the SAME constants the runtime applies) so the UI can show what’s actually used — model + effort + max_tokens + temperature + thinking budget — when an entity leaves a setting unset. Imported lazily inside the handler: model_router deliberately never imports src.runtime at module scope (the runtime imports model_router.service — a top-level import here risks a cycle).

GET

model-router

catalog

List selectable models plus per-role runtime model defaults

curl --request GET \
  --url https://api-sandbox.featherhq.com/v1/model-router/catalog \
  --header 'x-api-key: <api-key>'

{
  "models": [
    {
      "model_identifier": "<string>",
      "provider": "<string>",
      "supports_streaming": true,
      "max_context_window": 123,
      "input_price_per_1m": 123,
      "output_price_per_1m": 123,
      "supports_tools": true,
      "supports_vision": false,
      "regions": [
        "<string>"
      ],
      "family": "default",
      "supports_json_schema": true,
      "supports_reasoning_effort": false,
      "supports_temperature": true,
      "supports_thinking": false,
      "supports_audio": false,
      "compliance_tags": [
        "<string>"
      ]
    }
  ],
  "role_defaults": [
    {
      "role": "<string>",
      "model": "<string>",
      "reasoning_effort": "<string>",
      "max_tokens": 123,
      "temperature": 123,
      "thinking_budget": 123
    }
  ]
}

Authorizations

x-api-key

string

header

required

Response

Successful Response

Selectable models plus the per-role code defaults the runtime falls back to.

models

AvailableModel · object[]

required

Show child attributes

role_defaults

RoleModelDefault · object[]

required

Show child attributes

List model router configs

⌘I

List selectable models plus per-role runtime model defaults

curl --request GET \
  --url https://api-sandbox.featherhq.com/v1/model-router/catalog \
  --header 'x-api-key: <api-key>'

{
  "models": [
    {
      "model_identifier": "<string>",
      "provider": "<string>",
      "supports_streaming": true,
      "max_context_window": 123,
      "input_price_per_1m": 123,
      "output_price_per_1m": 123,
      "supports_tools": true,
      "supports_vision": false,
      "regions": [
        "<string>"
      ],
      "family": "default",
      "supports_json_schema": true,
      "supports_reasoning_effort": false,
      "supports_temperature": true,
      "supports_thinking": false,
      "supports_audio": false,
      "compliance_tags": [
        "<string>"
      ]
    }
  ],
  "role_defaults": [
    {
      "role": "<string>",
      "model": "<string>",
      "reasoning_effort": "<string>",
      "max_tokens": 123,
      "temperature": 123,
      "thinking_budget": 123
    }
  ]
}