Skip to content
CC Switch WikiUnofficial Community Wiki

Nvidia check failed: Not found (404) - cc-switch

Quick fix

Upgrade cc-switch to v3.16.3+; new version uses lightweight HTTP probing, fixing NVIDIA interface false 404 errors.

Symptom

Section titled “Symptom”
Error output
Nvidia 检查失败: Not found (404)
English translation

Nvidia check failed: Not found (404)

Cause

Section titled “Cause”

In cc-switch v3.16.2 and earlier, the 'Manage & Speed Test' feature sent real model requests or accessed specific API paths (e.g., `/v1/models`) for connectivity testing. Since the NVIDIA API (`integrate.api.nvidia.com`) does not support these test endpoints, it returns a 404 error directly, causing actual inference to be falsely reported as unavailable. Some users may see variant errors like `Nvidia 检查失败: HTTP 404: 404 page not found`, with the same root cause.

Fix

Section titled “Fix”

  1. Upgrade cc-switch to v3.16.3 or later.

  2. Re-enter the NVIDIA provider edit page and click 'Manage & Speed Test'. In v3.16.3, connectivity checks changed to directly GET the provider's `base_url`; any HTTP response is considered reachable, eliminating false 404 reports.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version<= 3.16.2
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Actual model calls work fine, why does speed test still report an error?
This is a speed test mechanism issue in older versions of cc-switch; it requested endpoints unsupported by NVIDIA. As long as actual inference works normally, you can use it normally. Upgrading to v3.16.3 is recommended to eliminate false reports.
What should I do if 404 errors persist after enabling local routing mapping?
Enabling routing mapping cannot resolve the issue of old versions requesting wrong endpoints during speed tests. This is a software bug; please upgrade cc-switch directly to v3.16.3.
Section titled “Related problems”
Upstream HTTP 404 cc-switchUpgrade cc-switch to remove ?beta=true from NVIDIA requests. Kimi does not support Codex's Responses API; use Claude Code or a local adapter.2 issues mergedAPI Error: 400 Param Incorrect Claude CodeUpgrade CC Switch to v3.16.2+ to fix 400 errors caused by missing reasoning_content in MiMo thinking mode.2 issues mergedAPI Error: 401 authentication_errorCheck the API key field, Base URL, key type, and cc-switch version, so Claude Code actually reads a valid credential.7 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.