Skip to content

fix: Improve error message for 401 / invalid API key (avoid "local ...#5808

Merged
HenryHengZJ merged 1 commit intoFlowiseAI:mainfrom
bintocher:bintocher/issue-5776
Feb 26, 2026
Merged

fix: Improve error message for 401 / invalid API key (avoid "local ...#5808
HenryHengZJ merged 1 commit intoFlowiseAI:mainfrom
bintocher:bintocher/issue-5776

Conversation

@bintocher
Copy link
Copy Markdown
Contributor

Summary

Improves the error message shown when a 401 Unauthorized error occurs due to an invalid or missing API key. The previous message mentioning "local model configuration" was confusing users, as this error typically indicates an API key issue rather than a local model configuration problem.

Issue

Fixes #5776

Changes

  • Updated error message in errorHandlerMiddleware from "Invalid model key or Incorrect local model configuration" to "Unauthorized – check your API key and ensure it has access to the requested model"
  • Updated the same error message in SSEStreamer.streamErrorEvent for consistency across both error handling paths

Testing

  • Verified the error message changes are applied in both the middleware and SSE streamer error handlers
  • The new message clearly directs users to check their API key configuration

The previous error message mentioned "local model configuration"
which could confuse users who don't use local models. The new message
clearly directs users to check their API key and model access.
Fixes FlowiseAI#5776
@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello @bintocher, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request aims to enhance the user experience by clarifying error messages related to 401 Unauthorized responses. It replaces a potentially confusing message about "local model configuration" with a more direct and helpful message that guides users to verify their API key and its access to the requested model, thereby streamlining troubleshooting for API key-related issues.

Highlights

  • Improved Error Messaging: The pull request updates the error message for 401 Unauthorized errors, specifically when an invalid or missing API key is the cause.
  • Enhanced User Guidance: The new error message provides clearer instructions, directing users to check their API key and its access permissions, rather than suggesting a "local model configuration" issue.
  • Consistent Error Handling: The updated error message is applied consistently across both the errorHandlerMiddleware and SSEStreamer.streamErrorEvent paths.
Changelog
  • packages/server/src/middlewares/errors/index.ts
    • Updated the error message for 401 "Incorrect API key provided" to "401 Unauthorized – check your API key and ensure it has access to the requested model."
  • packages/server/src/utils/SSEStreamer.ts
    • Modified the error message for 401 "Incorrect API key provided" to "401 Unauthorized – check your API key and ensure it has access to the requested model."
Activity
  • No human activity has been recorded on this pull request yet.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

The pull request successfully improves the user-facing error message for 401 Unauthorized errors, making it more descriptive and actionable by removing confusing references to local model configuration. The changes are applied consistently across the error middleware and the SSE streamer. The primary improvement opportunity is to centralize the hardcoded strings to avoid duplication and improve maintainability.

Comment on lines 9 to +10
if (err.message.includes('401 Incorrect API key provided'))
err.message = '401 Invalid model key or Incorrect local model configuration.'
err.message = '401 Unauthorized – check your API key and ensure it has access to the requested model.'
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The error message and the search pattern are hardcoded here and duplicated in packages/server/src/utils/SSEStreamer.ts. Consider moving these strings to a shared constants file to prevent inconsistency and reduce maintenance overhead in the future.

Comment on lines +209 to +210
if (msg.includes('401 Incorrect API key provided'))
msg = '401 Unauthorized – check your API key and ensure it has access to the requested model.'
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

This logic and the error message string are identical to the implementation in errorHandlerMiddleware. Centralizing these values in a shared constant would be more maintainable and less prone to errors during future updates.

@HenryHengZJ HenryHengZJ merged commit 942c75e into FlowiseAI:main Feb 26, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve error message for 401 / invalid API key (avoid "local model" confusion)

2 participants