8. Model providers
[!ref] Full details in the User Manual, "Models and parameters".
8.1 Provider fields
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | ✓ | Provider id |
display_name |
string | Display name | |
base_url |
string | ✓ | API base URL |
api_key |
string | Credential (shared quota is auto-issued; no entry needed) | |
protocol |
enum | ✓ | openai-compat / anthropic / gemini / custom |
models |
array | Model list; if empty, pulled at startup | |
priority |
int | 100 | Fallback ordering |
enabled |
bool | true | Active |
api.headers |
map[string]string | Custom request headers (your own providers only; each row is applied with Header.Set after built-in headers — overrides allowed; empty keys and entries containing CR/LF are skipped; Host header has no effect) |
8.2 Built-in provider placeholders
| name | Description |
|---|---|
AVL-Zero |
Shared-quota entry; auto-issues key on sign-in |
OpenAI |
Standard OpenAI protocol |
Anthropic |
Claude family |
Aliyun |
Aliyun Tongyi |
Volcengine |
Volcengine |
8.3 Parameter name mapping
| Common | OpenAI | Anthropic | Aliyun |
|---|---|---|---|
| temperature | temperature |
temperature |
temperature |
| top_p | top_p |
top_p |
top_p |
| max_output_tokens | max_tokens |
max_tokens |
max_tokens |
| stream | stream |
stream |
stream |
| stop | stop |
stop_sequences |
stop |
