# Providers & Models

Settings → Providers & Models controls which model the agent uses, and lets you add model providers beyond the PHOENIQS AI Model Service.

Settings → Providers & Models: Default models
Settings → Providers & Models: Default models

# Default models

Setting What it does
Default model The model a new session starts with.
Small model The model used for small background tasks, such as writing session titles and summaries.

Server default keeps the model your workspace is set up with, served by the PHOENIQS AI Model Service through your Base LLM API. The Terminal shows the model in use under the prompt.

# Providers

Every workspace comes with Phoeniqs MaaS, the PHOENIQS AI Model Service, connected with the key created when the workspace was provisioned. Providers that come with the deployment are read-only here. Providers you add are stored in your own settings, where you can edit and remove them.

# Adding a provider

  1. Click Add provider.
  2. Fill in the provider's details:
    • Provider id and Display name
    • SDK package, the library used to talk to the provider. For any OpenAI-compatible API, use @ai-sdk/openai-compatible.
    • Base URL of the provider's API
    • API key, optional at this point
  3. Save, then add the provider's models with Add model on its row. For each model, enter its Model id and Display name, its Context and Max output in tokens, its Cost for input and output in dollars per million tokens, and whether it supports Attachments, Reasoning and Tool calls.

The cost figures are what the Terminal uses to show what a session has cost so far.

The API key is never written into your settings file. It is kept in the workspace's encrypted credential store, and you can replace it later under Credentials → Provider API keys.


Credentials
../credentials/
Terminal
../../terminal/