DeepSeekDSH
Fix an error中文GitHub
Menu
Independent community guideNot affiliated with DeepSeek.Official source snapshot
Home›Error Fixes

UNKNOWN_MODEL Error

Fix UNKNOWN_MODEL by checking the exact Model ID, provider Base URL and model list, then selecting or adding a model that actually exists.

On this page

First, match UNKNOWN_MODEL

This page targets UNKNOWN_MODEL. The full message can contain a few extra words on different operating systems or Node.js versions, but the core error code or phrase should match.

UNKNOWN_MODEL
unknown model
DSH UNKNOWN_MODEL

When searching or asking for help, copy the full error and remove API keys, private repository names, usernames and sensitive paths.

Fast fix: UNKNOWN_MODEL

Open Settings → Models, check the provider Base URL and its current model list, then select an exact Model ID that exists. Do not copy a marketing name or an old screenshot without checking it.

What UNKNOWN_MODEL means

The current session references a Model ID that the active provider configuration does not expose.

Common causes of UNKNOWN_MODEL

  • The Model ID was renamed, removed or typed incorrectly.
  • A saved default still points to a provider that was deleted or replaced.
  • Model discovery failed, so the custom model was never added.
  • An older session still stores a different model from the current default.

Source trace for UNKNOWN_MODEL

These links are pinned to the 0.1.2-alpha.5 / 49a606b snapshot used for this page. They help separate UNKNOWN_MODEL from failures produced by Node.js, PowerShell, the operating-system network stack or filesystem permissions.

Provider troubleshootingThe official provider guide names UNKNOWN_MODEL directly and says to select a configured model or add the missing model to the custom provider.

Fix UNKNOWN_MODEL

  1. 01

    Check the exact Model ID

    Compare the selected Model ID with the provider's current list. Case, punctuation and provider prefixes can matter.

  2. 02

    Check the provider

    Open Settings → Models and confirm that the model belongs to the provider whose Base URL and credential you configured.

  3. 03

    Refresh or add the model

    Use model discovery when the provider supports GET /models. If it does not, add the exact verified Model ID manually.

  4. 04

    Test in a new session

    Select the corrected model and create a new session if the old session still points to the previous model.

Verify UNKNOWN_MODEL is fixed

  • The model appears under the intended provider.
  • A new session sends a small prompt without UNKNOWN_MODEL.
What to avoid
  • Do not guess a Model ID from a product or marketing name.
  • Do not assume that changing the global default rewrites an existing session.

UNKNOWN_MODEL FAQ

How do I fix UNKNOWN_MODEL?

Open Settings → Models, check the provider Base URL and its current model list, then select an exact Model ID that exists. Do not copy a marketing name or an old screenshot without checking it.

What does UNKNOWN_MODEL mean?

The current session references a Model ID that the active provider configuration does not expose.

How do I verify UNKNOWN_MODEL is fixed?

The model appears under the intended provider. A new session sends a small prompt without UNKNOWN_MODEL.

Sources and version

Checked against the official repository on 2026-09-03. Published version baseline: 0.1.1-rc.2; source snapshot: 0.1.2-alpha.5 (49a606b).

Official README · Verified source commit · GitHub Discussions