From 3353de91b8b35f158e63473ee2f9a08914484ca5 Mon Sep 17 00:00:00 2001
From: paisley <8197966+su8su@users.noreply.github.com>
Date: Sat, 28 Feb 2026 18:11:16 +0800
Subject: [PATCH] feat(providers): add API key apply links and update Qwen auth
 mode (#232)

---
 src/components/settings/ProvidersSettings.tsx | 28 ++++++++++++++++++-
 src/i18n/locales/en/settings.json             |  1 +
 src/i18n/locales/zh/settings.json             |  1 +
 src/lib/providers.ts                          |  8 ++++--
 4 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/src/components/settings/ProvidersSettings.tsx b/src/components/settings/ProvidersSettings.tsx
index 2fe7ae756..745f0fd2e 100644
--- a/src/components/settings/ProvidersSettings.tsx
+++ b/src/components/settings/ProvidersSettings.tsx
@@ -327,6 +327,19 @@ function ProviderCard({
                 )}
               </>
             )}
+            {typeInfo?.apiKeyUrl && (
+              <div className="flex justify-start mb-1">
+                <a
+                  href={typeInfo.apiKeyUrl}
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  className="text-xs text-primary hover:underline flex items-center gap-1"
+                  tabIndex={-1}
+                >
+                  {t('aiProviders.oauth.getApiKey')} <ExternalLink className="h-3 w-3" />
+                </a>
+              </div>
+            )}
             <div className="flex gap-2">
               <div className="relative flex-1">
                 <Input
@@ -708,7 +721,20 @@ function AddProviderDialog({ existingTypes, onClose, onAdd, onValidateKey }: Add
               {/* API Key input — shown for non-OAuth providers or when apikey mode is selected */}
               {(!isOAuth || (supportsApiKey && authMode === 'apikey')) && (
                 <div className="space-y-2">
-                  <Label htmlFor="apiKey">{t('aiProviders.dialog.apiKey')}</Label>
+                  <div className="flex items-center justify-between">
+                    <Label htmlFor="apiKey">{t('aiProviders.dialog.apiKey')}</Label>
+                    {typeInfo?.apiKeyUrl && (
+                      <a
+                        href={typeInfo.apiKeyUrl}
+                        target="_blank"
+                        rel="noopener noreferrer"
+                        className="text-xs text-primary hover:underline flex items-center gap-1"
+                        tabIndex={-1}
+                      >
+                        {t('aiProviders.oauth.getApiKey')} <ExternalLink className="h-3 w-3" />
+                      </a>
+                    )}
+                  </div>
                   <div className="relative">
                     <Input
                       id="apiKey"
diff --git a/src/i18n/locales/en/settings.json b/src/i18n/locales/en/settings.json
index 9ad3a967e..50fc00b64 100644
--- a/src/i18n/locales/en/settings.json
+++ b/src/i18n/locales/en/settings.json
@@ -61,6 +61,7 @@
       "apikeyMode": "API Key",
       "loginPrompt": "This provider requires signing in via your browser.",
       "loginButton": "Login with Browser",
+      "getApiKey": "Get API Key",
       "waiting": "Waiting...",
       "openLoginPage": "Open Login Page",
       "waitingApproval": "Waiting for approval in browser...",
diff --git a/src/i18n/locales/zh/settings.json b/src/i18n/locales/zh/settings.json
index ed19ca0a3..082815b9a 100644
--- a/src/i18n/locales/zh/settings.json
+++ b/src/i18n/locales/zh/settings.json
@@ -61,6 +61,7 @@
       "apikeyMode": "API 密钥",
       "loginPrompt": "此提供商需要通过浏览器登录授权。",
       "loginButton": "浏览器登录",
+      "getApiKey": "获取 API 密钥",
       "waiting": "等待中...",
       "openLoginPage": "打开登录页面",
       "waitingApproval": "等待浏览器中的授权...",
diff --git a/src/lib/providers.ts b/src/lib/providers.ts
index b6698b16e..990f7d0cf 100644
--- a/src/lib/providers.ts
+++ b/src/lib/providers.ts
@@ -59,6 +59,8 @@ export interface ProviderTypeInfo {
   isOAuth?: boolean;
   /** Whether this provider also accepts a direct API key (in addition to OAuth) */
   supportsApiKey?: boolean;
+  /** URL where users can apply for the API Key */
+  apiKeyUrl?: string;
 }
 
 import { providerIcons } from '@/assets/providers';
@@ -72,9 +74,9 @@ export const PROVIDER_TYPE_INFO: ProviderTypeInfo[] = [
   { id: 'ark', name: 'ByteDance Ark', icon: 'A', placeholder: 'your-ark-api-key', model: 'Doubao', requiresApiKey: true, defaultBaseUrl: 'https://ark.cn-beijing.volces.com/api/v3', showBaseUrl: true, showModelId: true, modelIdPlaceholder: 'ep-20260228000000-xxxxx' },
   { id: 'moonshot', name: 'Moonshot (CN)', icon: '🌙', placeholder: 'sk-...', model: 'Kimi', requiresApiKey: true, defaultBaseUrl: 'https://api.moonshot.cn/v1', defaultModelId: 'kimi-k2.5' },
   { id: 'siliconflow', name: 'SiliconFlow (CN)', icon: '🌊', placeholder: 'sk-...', model: 'Multi-Model', requiresApiKey: true, defaultBaseUrl: 'https://api.siliconflow.cn/v1', defaultModelId: 'Pro/moonshotai/Kimi-K2.5' },
-  { id: 'minimax-portal', name: 'MiniMax (Global)', icon: '☁️', placeholder: 'sk-...', model: 'MiniMax', requiresApiKey: false, isOAuth: true, supportsApiKey: true, defaultModelId: 'MiniMax-M2.5' },
-  { id: 'minimax-portal-cn', name: 'MiniMax (CN)', icon: '☁️', placeholder: 'sk-...', model: 'MiniMax', requiresApiKey: false, isOAuth: true, supportsApiKey: true, defaultModelId: 'MiniMax-M2.5' },
-  { id: 'qwen-portal', name: 'Qwen', icon: '☁️', placeholder: 'sk-...', model: 'Qwen', requiresApiKey: false, isOAuth: true, supportsApiKey: true, defaultModelId: 'coder-model' },
+  { id: 'minimax-portal', name: 'MiniMax (Global)', icon: '☁️', placeholder: 'sk-...', model: 'MiniMax', requiresApiKey: false, isOAuth: true, supportsApiKey: true, defaultModelId: 'MiniMax-M2.5', apiKeyUrl: 'https://intl.minimaxi.com/' },
+  { id: 'minimax-portal-cn', name: 'MiniMax (CN)', icon: '☁️', placeholder: 'sk-...', model: 'MiniMax', requiresApiKey: false, isOAuth: true, supportsApiKey: true, defaultModelId: 'MiniMax-M2.5', apiKeyUrl: 'https://platform.minimaxi.com/' },
+  { id: 'qwen-portal', name: 'Qwen', icon: '☁️', placeholder: 'sk-...', model: 'Qwen', requiresApiKey: false, isOAuth: true, defaultModelId: 'coder-model' },
   { id: 'ollama', name: 'Ollama', icon: '🦙', placeholder: 'Not required', requiresApiKey: false, defaultBaseUrl: 'http://localhost:11434', showBaseUrl: true, showModelId: true, modelIdPlaceholder: 'qwen3:latest' },
   { id: 'custom', name: 'Custom', icon: '⚙️', placeholder: 'API key...', requiresApiKey: true, showBaseUrl: true, showModelId: true, modelIdPlaceholder: 'your-provider/model-id' },
 ];