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

# Choose your generative model

> Pick the right model for speed, quality, vision, and privacy in Alter

Use this when you want better results for a specific task, not just the default model.

## Quick model selection in chat

<Steps>
  <Step title="Open model picker">
    In Alter, type `/` to open the model list.
  </Step>

  <Step title="Choose the model">
    Select a model based on your task type, then send your prompt.
  </Step>

  <Step title="Favorite frequent models">
    Click the star next to a model to pin it for faster access.
  </Step>
</Steps>

## Set your default model

Use `/` in the prompt box to open the model switcher, or press **/** anywhere in a Hub or QuickHub conversation. The selected model becomes your default immediately and stays active until you choose another one.

The switcher groups **Current**, **Favorites**, and **Other models**. Each row shows context length, vision support, and — when the model supports it — a **Thinking effort** control.

## Thinking effort

Supported models advertise graded thinking levels — typically **Low**, **Balanced**, and **Max**. Choose the level that matches your task:

| Level | Best for |
| - | - |
| **Low** | Quick replies, simple edits, lightweight follow-ups |
| **Balanced** | Everyday chat and most actions (default when available) |
| **Max** | Deep analysis, complex planning, and harder coding tasks |

Change thinking effort from:

* The **model switcher** in Hub or QuickHub — click the effort badge on a row, or use **←** / **→** while a row is highlighted
* **Action Editor → Model** — set effort for a specific action's pinned model

Alter remembers your choice **per model** and reuses it in future chats and actions. Reasoning context is preserved across follow-up turns on supported providers, so you can keep iterating without losing depth.

<Tip>
  Not every model exposes thinking effort. If a row has no effort badge, the model either runs at a fixed depth or does not advertise graded reasoning.
</Tip>

## Practical model choices

* Use a fast model for short daily tasks.
* Use a stronger reasoning model for complex planning or coding.
* Use a vision-capable model when you add images.
* Use local or custom models when privacy requirements are stricter.

<Tip>
  If you are unsure, start with `/best`, then switch only when you need lower latency or a specific capability.
</Tip>

## Related pages

* [Use your own API key](/how-to/use-byok)
* [API model names](/references/api-model-names)
* [API Gateway guide](/api-router/api-gateway)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.