docs(coding-agent): clarify models.json name behavior (fixes #1840)

This commit is contained in:
Mario Zechner 2026-03-05 20:16:28 +01:00
parent 708ce9d4ce
commit 3daf72d720

View file

@ -129,7 +129,7 @@ The `apiKey` and `headers` fields support three formats:
| Field | Required | Default | Description | | Field | Required | Default | Description |
|-------|----------|---------|-------------| |-------|----------|---------|-------------|
| `id` | Yes | — | Model identifier (passed to the API) | | `id` | Yes | — | Model identifier (passed to the API) |
| `name` | No | `id` | Display name in model selector | | `name` | No | `id` | Human-readable model label. Used for matching (`--model` patterns) and shown in model details/status text. |
| `api` | No | provider's `api` | Override provider's API for this model | | `api` | No | provider's `api` | Override provider's API for this model |
| `reasoning` | No | `false` | Supports extended thinking | | `reasoning` | No | `false` | Supports extended thinking |
| `input` | No | `["text"]` | Input types: `["text"]` or `["text", "image"]` | | `input` | No | `["text"]` | Input types: `["text"]` or `["text", "image"]` |
@ -137,6 +137,10 @@ The `apiKey` and `headers` fields support three formats:
| `maxTokens` | No | `16384` | Maximum output tokens | | `maxTokens` | No | `16384` | Maximum output tokens |
| `cost` | No | all zeros | `{"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}` (per million tokens) | | `cost` | No | all zeros | `{"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}` (per million tokens) |
Current behavior:
- `/model` and `--list-models` list entries by model `id`.
- The configured `name` is used for model matching and detail/status text.
## Overriding Built-in Providers ## Overriding Built-in Providers
Route a built-in provider through a proxy without redefining models: Route a built-in provider through a proxy without redefining models: