docs/models/custom.mdx
For model services accessed via the OpenAI-compatible protocol, such as:
Recommended. On the "Models" page of the Web console, click "Add Provider" and pick "Custom", then fill in the name, API Base and API Key. Multiple custom providers can be added; after adding one, select it together with a model in the "Main Model" card to enable it.
Default endpoints of common local deployment tools:
| Tool | Default API Base |
|---|---|
| Ollama | http://localhost:11434/v1 |
| vLLM | http://localhost:8000/v1 |
| LocalAI | http://localhost:8080/v1 |
You can also edit config.json directly: define multiple providers in the custom_providers list and set bot_type to "custom:<id>" to activate one of them:
{
"bot_type": "custom:3f2a9c1b",
"custom_providers": [
{
"id": "3f2a9c1b",
"name": "ProviderA",
"api_key": "YOUR_API_KEY_A",
"api_base": "https://api.a.com/v1",
"model": "deepseek-v3"
},
{
"id": "a1b2c3d4",
"name": "ProviderB",
"api_key": "YOUR_API_KEY_B",
"api_base": "https://api.b.com/v1",
"model": "qwen3-max"
}
]
}
| Parameter | Description |
|---|---|
custom_providers | List of custom providers; each item has id, name, api_base, api_key (optional) and model (optional) |
bot_type | Set to "custom:<id>" to activate the corresponding provider |
id | Unique identifier (8-char hex); auto-generated when adding via the Web console, or any unique string when editing manually |
name | Display label, can be renamed freely |
model | Model used by this provider, takes effect when activated |