> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shuttleai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Models

> ShuttleAI gives you access to the world's best AI models through a single API.

ShuttleAI provides access to models from **OpenAI**, **Anthropic**, **open-source communities**, and our own proprietary routing model — all through one unified, OpenAI-compatible API.

<Info>
  Our model list is updated frequently. For the most current list of available models, visit [shuttleai.com/models](https://shuttleai.com/models).
</Info>

## Featured models

| Model                 | Provider  | Context | Tier    | Highlights                                        |
| --------------------- | --------- | ------- | ------- | ------------------------------------------------- |
| **ShuttleAI Auto**    | ShuttleAI | 400K    | Basic   | Smart router — picks the best model automatically |
| **GPT-5.2**           | OpenAI    | 400K    | Basic   | Latest GPT-5 series with improved reasoning       |
| **GPT-OSS 120B**      | OpenAI    | 131K    | Free    | High-performance open-source model                |
| **GPT-OSS 20B**       | OpenAI    | 131K    | Free    | Lightweight open-source model                     |
| **Claude Opus 4.6**   | Anthropic | 200K    | Premium | Anthropic's most intelligent model                |
| **Claude Sonnet 4.6** | Anthropic | 200K    | Premium | Best balance of speed and intelligence            |
| **Claude Haiku 4.5**  | Anthropic | 200K    | Basic   | Ultra-fast with near-frontier intelligence        |

## Model tiers

Every model is assigned to a **tier** that determines which [plan](/pricing/plans) you need:

<CardGroup cols={3}>
  <Card title="Free" icon="gift">
    Open-source models like GPT-OSS 20B and GPT-OSS 120B. No plan required.
  </Card>

  <Card title="Basic" icon="star">
    GPT-5.2, Claude Haiku 4.5, ShuttleAI Auto, and more. Requires the **Basic** plan (\$10/mo) or higher.
  </Card>

  <Card title="Premium" icon="crown">
    Frontier models like Claude Opus 4.6 and Claude Sonnet 4.6. Requires the **Premium** plan (\$25/mo) or higher.
  </Card>
</CardGroup>

## Listing models via API

Fetch all available models programmatically:

```bash theme={null}
curl https://api.shuttleai.com/v1/models \
  -H "Authorization: Bearer shuttle-xxx"
```

For detailed model info including context limits, tool support, and plan requirements:

```bash theme={null}
curl https://api.shuttleai.com/v1/models/verbose \
  -H "Authorization: Bearer shuttle-xxx"
```

### Verbose response fields

Each model in the verbose response includes:

| Field                       | Description                                                                |
| --------------------------- | -------------------------------------------------------------------------- |
| `id`                        | Model ID to use in API requests                                            |
| `plan`                      | Minimum plan tier required (`free`, `basic`, `premium`)                    |
| `request_multiplier`        | Cost multiplier applied to this model ([learn more](/pricing/multipliers)) |
| `permission.context_length` | Maximum input context window                                               |
| `permission.max_output`     | Maximum output tokens                                                      |
| `permission.tool_calling`   | Whether the model supports tool/function calling                           |

## Using a model

Specify the model ID in the `model` field of your request:

```python theme={null}
response = client.chat.completions.create(
    model="gpt-5.2",  # or "shuttleai/auto", "claude-opus-4.6", etc.
    messages=[{"role": "user", "content": "Hello!"}]
)
```

<Tip>
  Not sure which model to use? Try [ShuttleAI Auto](/models/shuttleai-auto) — it intelligently routes your request to the best model for the job and is the most cost-efficient option.
</Tip>

<Card title="Browse all models →" icon="grid-2" href="https://shuttleai.com/models">
  See the full, always-up-to-date list of available models at shuttleai.com/models.
</Card>