Function parseApiError

packages/mcp/src/utils/coreUtils.js:242–282

(status, errorText)

 * @returns {string} - User-friendly error message
 */
export function parseApiError(status, errorText) {
    let parsed = null;
    try {
        parsed = JSON.parse(errorText);
    } catch {}
    const errorMessage =
        parsed?.error?.message || parsed?.message || parsed?.error || errorText;
    switch (status) {
        case 400:
            if (
                errorMessage.toLowerCase().includes("content moderation") ||
                errorMessage.toLowerCase().includes("safety") ||
                errorMessage.toLowerCase().includes("blocked")
            ) {
                return `Content blocked by safety filters. Try rephrasing your prompt or disable 'safe' mode if appropriate.`;
            }
            if (errorMessage.toLowerCase().includes("invalid model")) {
                return `Invalid model specified. Use listImageModels or listTextModels to see available options.`;
            }
            return `Bad request: ${errorMessage}`;
        case 401:
            return `Authentication failed. Please set a valid API key using setApiKey. Get your key at https://enter.pollinations.ai`;
        case 403:
            return `Access forbidden. Your API key may not have permission for this operation.`;
        case 404:
            return `Resource not found. The requested endpoint or model may not exist.`;
        case 429:
            return (
                `Rate limited. You're making too many requests. ` +
                `If using pk_ (publishable) key, consider upgrading to sk_ (secret) key for higher limits.`
            );
        case 500:
            return `Server error: ${errorMessage}. Please try again later.`;
        case 502:
        case 503:
        case 504:
            return `Service temporarily unavailable. Please try again in a few moments.`;
        default:
            return `Request failed (${status}): ${errorMessage}`;
    }
}