Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/thePrnvBot/dispel-web-stylist/llms.txt

Use this file to discover all available pages before exploring further.

Dispel lets you configure as many AI models as you like, spanning multiple providers, and switch between them at any time from the side panel’s prompt input area. Each configuration entry stores the provider type, the model ID that is sent to the API, the base URL, and a display name — giving you complete control over which model handles your styling requests and making it easy to compare outputs across providers or model tiers.

​
Model configuration fields

Each model entry in Dispel’s storage conforms to ModelConfigSchema from src/utils/schemas/storage.ts. The following fields make up a complete model configuration:
​
id
string
required
Internal unique identifier generated at save time using crypto.randomUUID(). You never set this manually — Dispel assigns it automatically when you save a new model entry.
​
modelId
string
required
The model identifier sent verbatim to the provider’s API in the request body. For OpenRouter, the value must use the full provider/model-name slash-separated format (e.g. openai/gpt-4o or anthropic/claude-opus-4-5) — Dispel validates this structure at save time. For all other providers it is the full model name as listed in the provider’s documentation (e.g. gpt-4o, claude-opus-4-5, gemini-2.0-flash).
​
provider
'openai' | 'anthropic' | 'google' | 'openrouter' | 'local'
required
Determines which SDK factory Dispel uses to build the language model instance. Each value maps to a dedicated adapter: openai → @ai-sdk/openai, anthropic → @ai-sdk/anthropic, google → @ai-sdk/google, openrouter → @openrouter/ai-sdk-provider, local → @ai-sdk/openai-compatible.
​
baseUrl
string
required
The API base URL for this model. For all built-in providers this is pre-filled from the provider preset and is read-only in the form unless you choose the local provider type. For local (and any OpenAI-compatible endpoint) you can enter any valid URL. When Dispel detects that the base URL origin matches https://openrouter.ai, it omits the override so the OpenRouter adapter uses its own default.
​
chef
string
Display name shown in the model selector in the side panel. For OpenRouter models this is derived from the provider prefix in uppercase (e.g. OPENAI). For all other providers it is the model ID in uppercase. This field is computed automatically on save and is not user-editable in the current UI.
​
chefSlug
string
URL-safe slug used internally to reconstruct the full OpenRouter model ID. For OpenRouter models it holds the provider prefix (e.g. openai from openai/gpt-4o). For all other providers it is an empty string. This field is also computed automatically on save.

​
Adding a model

1

Open the Options page

Right-click the Dispel toolbar icon and choose Options, or click the gear icon in the side panel header.
2

Go to the Models tab

Click Models in the tab bar at the top of the Options page. The model configuration form is displayed at the top.
3

Select a provider

Choose a provider from the Provider dropdown. Dispel fills in the preset base URL and loads any previously saved API key for that provider automatically.
4

Fill in the form

Enter your API Key (not required for the local provider type), verify the Base URL, and type the Model ID exactly as it appears in your provider’s model list.
5

Save the model

Click Save. The new entry appears in the Your models table below the form. Dispel stores the model configuration in local:models and writes the API key to local:apiKeys under the corresponding provider key.
The model ID is passed directly to the provider API without transformation (except for OpenRouter, where the provider prefix is split out internally). Verify the exact identifier in your provider’s model catalog before saving to avoid API errors at inference time.

​
Editing a model

To update an existing model configuration, click the edit (pencil) icon on the model’s row in the Your models table. The form pre-populates with the stored values — including the API key retrieved from local:apiKeys for that provider — and the Save button changes to Update. Make your changes and click Update to write them back to storage. Click Reset to restore the form to its default values without saving.

​
Deleting a model

Click the delete (trash) icon on the model’s row. The entry is removed from local:models immediately. The associated API key stored in local:apiKeys is not deleted, because other model configurations for the same provider share it.

​
Selecting the active model

In the Dispel side panel, the model selector dropdown above the prompt input lists every configuration you have saved. Selecting a model sets it as the active model for that session. Dispel persists the last selected model ID in local:lastUsedModel so your choice is preserved across page navigations and browser restarts.
Use OpenRouter to access models from many providers — including OpenAI, Anthropic, Google, and dozens of open-weight models — with a single API key. Add one OpenRouter configuration per model tier you want to use (e.g. one entry for openai/gpt-4o and one for anthropic/claude-opus-4-5), all sharing the same API key.

​
Model IDs by provider

Dispel does not ship a built-in model catalog. You enter the model ID manually, exactly as it appears in the provider’s documentation. The table below shows representative IDs for each supported provider.
ProviderExample Model IDs
OpenAIgpt-4o, gpt-4o-mini, gpt-4.1
Anthropicclaude-opus-4-5, claude-sonnet-4-5, claude-haiku-3-5
Googlegemini-2.0-flash, gemini-2.5-pro
OpenRouteropenai/gpt-4o, anthropic/claude-opus-4-5
Localllama3.2, mistral (Ollama model names)
For OpenRouter, the model ID in the form must use the provider/model-name format. Dispel validates this at save time and shows an error if the slash-separated structure is missing.

Build docs developers (and LLMs) love

Get started for freeTalk to us