04 · 3 provider routes
Models and providers
It ships configured for DeepSeek, but it runs against almost any provider, including one of your own.
There are three routes.
- Route one DeepSeek Put the key in the models screen and you can start a session. The change takes effect on the next request, with no restart.
- Route two A known provider Anthropic, OpenAI and others are in a catalog. Pick one, add the key and it fills in the rest.
- Route three Your own endpoint A company gateway, your own server or any provider not on the list. There is a button that queries your server and pulls the list of available models, if your server exposes it.
The third one needs five fields.
| Field | What it is |
|---|---|
| identifier | The internal name of the provider. It can never be renamed |
| base URL | The address of the server |
| protocol | OpenAI-compatible, usually |
| credential | The key, stored separately |
| model | At least one registered |
Three details that save you time
- One Keys cannot be read back Once saved, the screen only ever gets a redacted version. The real value lives in a separate file and the configuration keeps only a reference.
- Two The identifier cannot be renamed Requests, saved sessions and credential references all use it. If you get it wrong you have to create another one and delete the old one.
- Three Images have to be declared A model you enter by hand is treated as if it did not accept images until you say otherwise. That is not an oversight: there is no way to ask a server which formats it accepts, so the system prefers not to assume.
Technical detail optional
The image declaration goes in the settings file, with input: [text, image] on the specific model. If every model on that route accepts them, defaultInput on the provider saves the repetition. On a catalog provider, where there is no model list to edit, it goes in modelOverrides. It is a statement about your server, not a check: if you lie, the error arrives later, when the provider rejects the request.
Errors you will see
| Error | What it almost always means |
|---|---|
| missing credential | It cannot find the key |
| unknown model | The chosen model is not registered on that provider |
| authorisation error | When listing models, it is the key |