---
title: "AutoRouterPlugin"
---

## Fields

| Field                                                                                                                                                                                                                              | Type                                                                                                                                                                                                                               | Required                                                                                                                                                                                                                           | Description                                                                                                                                                                                                                        | Example                                                                                                                                                                                                                            |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `allowed_models`                                                                                                                                                                                                                   | List[*str*]                                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                                                 | List of model patterns to filter which models the auto-router can route between. Supports wildcards (e.g., "anthropic/*" matches all Anthropic models). When not specified, uses the default supported models list.                | [<br/>"anthropic/*",<br/>"openai/gpt-4o",<br/>"google/*"<br/>]                                                                                                                                                                     |
| `cost_quality_tradeoff`                                                                                                                                                                                                            | *Optional[int]*                                                                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                                 | Controls cost vs. quality routing tradeoff (0–10). 0 = pure quality (best model regardless of cost), 10 = maximize for cost (cheapest model wins). Intermediate values blend quality and cost signals continuously. Defaults to 7. | 7                                                                                                                                                                                                                                  |
| `enabled`                                                                                                                                                                                                                          | *Optional[bool]*                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                 | Set to false to disable the auto-router plugin for this request. Defaults to true.                                                                                                                                                 |                                                                                                                                                                                                                                    |
| `id`                                                                                                                                                                                                                               | [components.AutoRouterPluginID](../components/autorouterpluginid.mdx)                                                                                                                                                               | :heavy_check_mark:                                                                                                                                                                                                                 | N/A                                                                                                                                                                                                                                |                                                                                                                                                                                                                                    |