Models

Your organization's Models page lists every model your organization can use. Owners and admins can change each model's settings; other members can view them. See Pricing for the models Radius serves and their prices.

Model types

There are three types of models:

What you can configure

Every model has these settings:

Virtual models also have a routing rule, which picks the model that handles each request.

You can delete Virtual and BYOK models you created. Resetting cheap, balanced, or precise restores the settings Radius provides.

How a request uses these settings

When someone sends a request to a model, Radius:

  1. Checks that the requester may use the model they selected.
  2. Lowers the requested thinking level to the model's maximum, if one is set.
  3. Runs the model's selected rewrite rules, in the order shown on the Rewrite rules page.
  4. For a Virtual model, runs its routing rule to pick a Built-in or BYOK model.
  5. Sends the request to the picked model.

Only the requested model's settings apply. If a Virtual model picks a Built-in model, the Built-in model's own thinking level and rewrite rules are not applied.

Manage models with an agent

Instead of using the Models page, you can ask Pi to manage models through the Radius MCP server. Ask Pi to read the current models before changing them. Models are managed with the models.list, models.upsert, and models.delete operations.

Virtual models

A Virtual model is a model name your team selects in Pi, such as balanced, while your organization decides which model actually answers. Use Virtual models to:

Each request to a Virtual model goes through its routing rule, which picks the Built-in or BYOK model that answers it. See Model types for how they fit together.

Virtual models have no price of their own. Each request is billed at the price of the model that answered it. In analytics, Requested model shows the model people selected, which can be a Built-in, Virtual, or BYOK model, and Physical model shows the model that answered.

Default Virtual models from Radius

Every organization starts with three Virtual models:

Each sends every request to one model chosen by Radius. Open it on the Models page to see which one. Radius may change these choices as better models become available.

You can change their settings like any other Virtual model. Once you do, your settings replace the ones Radius provides, so later Radius changes no longer apply to that model. Select Reset to default to return to the Radius settings.

Create a Virtual model

Owners and admins can create Virtual models:

  1. On the Models page, select New Virtual Model.
  2. Enter an ID. This is the name people select in Pi. Use lowercase letters and digits, starting with a letter, up to 64 characters. It can't match the ID of another model in your organization. The API is less strict: models.upsert also accepts hyphens and IDs that start with a digit, and an ID that already exists updates that model instead of creating a new one.
  3. Choose a routing rule:
    • Static sends every request to one model you select.
    • A custom routing rule picks a model for each request. Its settings appear after you select it. See Routing rules to write one.
  4. Set availability, maximum thinking level, and rewrite rules. See What you can configure.
  5. Select Create virtual model.

You can also ask Pi to create one for you. Set up Pi as described in Manage models with an agent, then describe what you want, for example: "Help me create a Radius virtual model that uses a fixed model but always appends a fixed instruction to the system prompt."

Change, rename, or delete

Changes apply to new messages, usually within moments and at most within an hour. A reply that is already in progress usually keeps the model it started with. See When routing rules run.

Renaming a Virtual model changes the name people select in Pi. Anyone using the old name has to switch to the new one. If you rename cheap, balanced, or precise, the original name is disabled.

You can delete Virtual models your organization created. You can't delete cheap, balanced, or precise, but you can disable them by setting their availability to Disabled.