Admin Guide
Model management
Manage metadata and pricing for every model on the platform
Maintain model names, descriptions, vendors, tags and pricing ratios here, and sync the model list from upstream channels. After signing in as an admin, open "Admin area → Model management" in the left sidebar, or go to `/console/models` directly. For what users see, check the Model Square at `/models`. The web console page follows the reference design and is still being wired up.
Tip: These settings mainly control how models are presented to users in the Model Square; they do not affect actual model calls or routing. To configure real call behavior, go to Channel management and set up channels and the ability table.
| Icon | Model name | Match type | Official sync | Description | Vendor | Actions | |
|---|---|---|---|---|---|---|---|
| ☐ | ◉ | gpt-4o | Exact | Yes | Multimodal flagship model | OpenAI | Disable · Edit · Delete |
| ☐ | ◉ | claude-3-5-sonnet | Exact | Yes | Long-context chat | Anthropic | Disable · Edit · Delete |
Model list preview: tip, toolbar and metadata table
Add and edit models
Add a model
- Click "Add model" to open the form
- Fill in
model_name, description, vendor and other metadata - Submit to
POST /api/models/to create the record
Edit model metadata
| Field | Description |
|---|---|
model_name · Model name | Required; must match the model parameter used in calls |
description · Description | Description shown in the Model Square |
icon · Icon | Card icon |
tags · Tags | e.g. chat, vision, reasoning |
vendor_id · Vendor | Linked vendor record or vendor identifier |
endpoints · Endpoints | JSON or a comma-separated list of supported API types |
name_rule · Match rule | How the model name is matched |
sync_official · Official sync | Whether the model takes part in upstream sync |
Click "Edit" in a row or call GET /api/models/{id} to view details, then save with PUT /api/models/.
Configure pricing
| Field | Description |
|---|---|
model_ratio · Model ratio | Billing ratio for input tokens; see the pricing docs for details |
completion_ratio · Completion ratio | Price multiplier for output tokens relative to input |
model_price · Fixed price | Unit price for per-call billed models (optional) |
cache_ratio · Cache ratio | Billing ratio for cache-hit tokens (if supported) |
For pricing rules and how prices appear to users, see the Pricing docs. Actual charges follow the usage logs.
Sync upstream models
Preview sync results
Before clicking "Sync", you can call GET /api/models/sync_upstream/preview to preview the models that will be added or updated from channels, so you don't overwrite metadata by mistake.
Run the sync
- After reviewing the preview, run
POST /api/models/sync_upstream - Sync merges model names from each channel's
modelsfield; it does not create channel routes automatically - Configure channel models and the ability table for real call routing in Channel management
Search and filter
Search models
- "Search model name" filters by model_name keyword
- "Search vendor" filters by vendor or vendor name
- Click "Search" to call GET /api/models?keyword=; "Reset" restores the default GET /api/models list
Unconfigured models
Click "Unconfigured models" or call GET /api/models/missing to list models that are enabled on channels but not yet in the metadata table, so you can fill in descriptions and pricing in bulk.
List fields and actions
| Column | Field | Description |
|---|---|---|
| Icon | icon | Display icon URL or built-in identifier |
| Model name | model_name | Matches the model field in API requests |
| Match type | name_rule | Name matching rule (exact, prefix, etc.) |
| Official sync | sync_official | Whether the model is included in the official model sync job |
| Description | description | Description shown on the Model Square card |
| Vendor | vendor_id | Vendor or model family |
| Tags | tags | Category tags, comma-separated |
| Endpoints | endpoints | Supported API endpoint types (e.g. chat, embedding) |
| Status | status | Enabled or disabled; disabled models are hidden from the Model Square |
- Add model (
POST /api/model): Manually enter model metadata and pricing - Unconfigured models (
GET /api/models/missing): List models supported by channels but missing metadata - Sync (
POST /api/models/sync_upstream): Pull models from upstream channels and merge their metadata - Manage by channel: Go to Channel management to configure each channel's models field and routing
- Compact list: Toggle table density and hide secondary columns
- Disable / Enable: Toggle status to control visibility in the Model Square
- Edit (
PUT /api/model/{id}): Update metadata and pricing - Delete (
DELETE /api/models/{id}): Delete the metadata record (models configured on channels are not affected)
User-facing list: /models (public GET /api/models). Admin sidebar module: sidebar_modules.admin.models.