free-coding-models 0.1.84 → 0.1.86

package/src/key-handler.js

@@ -1,6 +1,6 @@
 /**
  * @file key-handler.js
- * @description Factory for the main TUI keypress handler.
+ * @description Factory for the main TUI keypress handler and provider key-test model selection.
  *
  * @details
  *   This module encapsulates the full onKeyPress switch used by the TUI,
@@ -8,11 +8,93 @@
  *   OpenCode/OpenClaw launch actions. It also keeps the live key bindings
  *   aligned with the highlighted letters shown in the table headers.
  *
+ *   It also owns the "test key" model selection used by the Settings overlay.
+ *   Some providers expose models in `/v1/models` that are not actually callable
+ *   on the chat-completions endpoint. To avoid false negatives when a user
+ *   presses `T` in Settings, the helpers below discover candidate model IDs,
+ *   merge them with repo defaults, then probe several until one is accepted.
+ *
  *   → Functions:
+ *   - `buildProviderModelsUrl` — derive the matching `/models` endpoint when available
+ *   - `parseProviderModelIds` — extract model ids from an OpenAI-style `/models` payload
+ *   - `listProviderTestModels` — build an ordered candidate list for provider key verification
+ *   - `classifyProviderTestOutcome` — convert attempted HTTP codes into a settings badge state
  *   - `createKeyHandler` — returns the async keypress handler
  *
- * @exports { createKeyHandler }
+ * @exports { buildProviderModelsUrl, parseProviderModelIds, listProviderTestModels, classifyProviderTestOutcome, createKeyHandler }
+ */
+
+// 📖 Some providers need an explicit probe model because the first catalog entry
+// 📖 is not guaranteed to be accepted by their chat endpoint.
+const PROVIDER_TEST_MODEL_OVERRIDES = {
+  sambanova: ['DeepSeek-V3-0324'],
+  nvidia: ['deepseek-ai/deepseek-v3.1-terminus', 'openai/gpt-oss-120b'],
+}
+
+/**
+ * 📖 buildProviderModelsUrl derives the matching `/models` endpoint for providers
+ * 📖 that expose an OpenAI-compatible model list next to `/chat/completions`.
+ * @param {string} url
+ * @returns {string|null}
  */
+export function buildProviderModelsUrl(url) {
+  if (typeof url !== 'string' || !url.includes('/chat/completions')) return null
+  return url.replace(/\/chat\/completions$/, '/models')
+}
+
+/**
+ * 📖 parseProviderModelIds extracts ids from a standard OpenAI-style `/models` response.
+ * 📖 Invalid payloads return an empty list so the key-test flow can safely fall back.
+ * @param {unknown} data
+ * @returns {string[]}
+ */
+export function parseProviderModelIds(data) {
+  if (!data || typeof data !== 'object' || !Array.isArray(data.data)) return []
+  return data.data
+    .map(entry => (entry && typeof entry.id === 'string') ? entry.id.trim() : '')
+    .filter(Boolean)
+}
+
+/**
+ * 📖 listProviderTestModels builds the ordered probe list used by the Settings `T` key.
+ * 📖 Order matters:
+ * 📖 1. provider-specific known-good overrides
+ * 📖 2. discovered `/models` ids that also exist in this repo
+ * 📖 3. all discovered `/models` ids
+ * 📖 4. repo static model ids as final fallback
+ * @param {string} providerKey
+ * @param {{ models?: Array<[string, string, string, string, string]> } | undefined} src
+ * @param {string[]} [discoveredModelIds=[]]
+ * @returns {string[]}
+ */
+export function listProviderTestModels(providerKey, src, discoveredModelIds = []) {
+  const staticModelIds = Array.isArray(src?.models) ? src.models.map(model => model[0]).filter(Boolean) : []
+  const staticModelSet = new Set(staticModelIds)
+  const preferredDiscoveredIds = discoveredModelIds.filter(modelId => staticModelSet.has(modelId))
+  const orderedCandidates = [
+    ...(PROVIDER_TEST_MODEL_OVERRIDES[providerKey] ?? []),
+    ...preferredDiscoveredIds,
+    ...discoveredModelIds,
+    ...staticModelIds,
+  ]
+  return [...new Set(orderedCandidates)]
+}
+
+/**
+ * 📖 classifyProviderTestOutcome maps attempted probe codes to a user-facing test result.
+ * 📖 This keeps Settings more honest than a binary success/fail badge:
+ * 📖 - `rate_limited` means the key is valid but the provider is currently throttling
+ * 📖 - `no_callable_model` means the provider responded, but none of the attempted models were callable
+ * @param {string[]} codes
+ * @returns {'ok'|'fail'|'rate_limited'|'no_callable_model'}
+ */
+export function classifyProviderTestOutcome(codes) {
+  if (codes.includes('200')) return 'ok'
+  if (codes.includes('401') || codes.includes('403')) return 'fail'
+  if (codes.length > 0 && codes.every(code => code === '429')) return 'rate_limited'
+  if (codes.length > 0 && codes.every(code => code === '404' || code === '410')) return 'no_callable_model'
+  return 'fail'
+}
 
 export function createKeyHandler(ctx) {
   const {
@@ -65,6 +147,10 @@ export function createKeyHandler(ctx) {
     mergedModels,
     apiKey,
     chalk,
+    setPingMode,
+    noteUserActivity,
+    intervalToPingMode,
+    PING_MODE_CYCLE,
     setResults,
     readline,
   } = ctx
@@ -79,13 +165,45 @@ export function createKeyHandler(ctx) {
     const testKey = getApiKey(state.config, providerKey)
     if (!testKey) { state.settingsTestResults[providerKey] = 'fail'; return }
 
-    // 📖 Use the first model in the provider's list for the test ping
-    const testModel = src.models[0]?.[0]
-    if (!testModel) { state.settingsTestResults[providerKey] = 'fail'; return }
-
     state.settingsTestResults[providerKey] = 'pending'
-    const { code } = await ping(testKey, testModel, providerKey, src.url)
-    state.settingsTestResults[providerKey] = code === '200' ? 'ok' : 'fail'
+    const discoveredModelIds = []
+    const modelsUrl = buildProviderModelsUrl(src.url)
+
+    if (modelsUrl) {
+      try {
+        const headers = { Authorization: `Bearer ${testKey}` }
+        if (providerKey === 'openrouter') {
+          headers['HTTP-Referer'] = 'https://github.com/vava-nessa/free-coding-models'
+          headers['X-Title'] = 'free-coding-models'
+        }
+        const modelsResp = await fetch(modelsUrl, { headers })
+        if (modelsResp.ok) {
+          const data = await modelsResp.json()
+          discoveredModelIds.push(...parseProviderModelIds(data))
+        }
+      } catch {
+        // 📖 Discovery failure is non-fatal; we still have repo-defined fallbacks.
+      }
+    }
+
+    const candidateModels = listProviderTestModels(providerKey, src, discoveredModelIds)
+    if (candidateModels.length === 0) { state.settingsTestResults[providerKey] = 'fail'; return }
+    const attemptedCodes = []
+
+    for (const testModel of candidateModels.slice(0, 8)) {
+      const { code } = await ping(testKey, testModel, providerKey, src.url)
+      attemptedCodes.push(code)
+      if (code === '200') {
+        state.settingsTestResults[providerKey] = 'ok'
+        return
+      }
+      if (code === '401' || code === '403') {
+        state.settingsTestResults[providerKey] = 'fail'
+        return
+      }
+    }
+
+    state.settingsTestResults[providerKey] = classifyProviderTestOutcome(attemptedCodes)
   }
 
   // 📖 Manual update checker from settings; keeps status visible in maintenance row.
@@ -121,6 +239,7 @@ export function createKeyHandler(ctx) {
 
   return async (str, key) => {
     if (!key) return
+    noteUserActivity()
 
     // 📖 Profile save mode: intercept ALL keys while inline name input is active.
     // 📖 Enter → save, Esc → cancel, Backspace → delete char, printable → append to buffer.
@@ -141,6 +260,7 @@ export function createKeyHandler(ctx) {
             sortColumn: state.sortColumn,
             sortAsc: state.sortDirection === 'asc',
             pingInterval: state.pingInterval,
+            hideUnconfiguredModels: state.hideUnconfiguredModels,
           })
           setActiveProfile(state.config, name)
           state.activeProfile = name
@@ -503,7 +623,7 @@ export function createKeyHandler(ctx) {
             // 📖 Try to reuse existing result to keep ping history
             const existing = state.results.find(r => r.modelId === modelId && r.providerKey === providerKey)
             if (existing) return existing
-            return { idx: i + 1, modelId, label, tier, sweScore, ctx, providerKey, status: 'pending', pings: [], httpCode: null, hidden: false }
+            return { idx: i + 1, modelId, label, tier, sweScore, ctx, providerKey, status: 'pending', pings: [], httpCode: null, isPinging: false, hidden: false }
           })
         // 📖 Re-index results
         nextResults.forEach((r, i) => { r.idx = i + 1 })
@@ -524,6 +644,7 @@ export function createKeyHandler(ctx) {
               r.status = 'pending'
               r.pings = []
               r.httpCode = null
+              r.isPinging = false
               pingModel(r).catch(() => {})
             }
           })
@@ -582,7 +703,7 @@ export function createKeyHandler(ctx) {
             if (settings) {
               state.sortColumn = settings.sortColumn || 'avg'
               state.sortDirection = settings.sortAsc ? 'asc' : 'desc'
-              state.pingInterval = settings.pingInterval || PING_INTERVAL
+              setPingMode(intervalToPingMode(settings.pingInterval || PING_INTERVAL), 'manual')
               if (settings.tierFilter) {
                 const tierIdx = TIER_CYCLE.indexOf(settings.tierFilter)
                 if (tierIdx >= 0) state.tierFilterMode = tierIdx
@@ -753,6 +874,7 @@ export function createKeyHandler(ctx) {
           sortColumn: state.sortColumn,
           sortAsc: state.sortDirection === 'asc',
           pingInterval: state.pingInterval,
+          hideUnconfiguredModels: state.hideUnconfiguredModels,
         })
         setActiveProfile(state.config, 'default')
         state.activeProfile = 'default'
@@ -773,13 +895,14 @@ export function createKeyHandler(ctx) {
             // 📖 Apply profile's TUI settings to live state
             state.sortColumn = settings.sortColumn || 'avg'
             state.sortDirection = settings.sortAsc ? 'asc' : 'desc'
-            state.pingInterval = settings.pingInterval || PING_INTERVAL
+            setPingMode(intervalToPingMode(settings.pingInterval || PING_INTERVAL), 'manual')
             if (settings.tierFilter) {
               const tierIdx = TIER_CYCLE.indexOf(settings.tierFilter)
               if (tierIdx >= 0) state.tierFilterMode = tierIdx
             } else {
               state.tierFilterMode = 0
             }
+            state.hideUnconfiguredModels = settings.hideUnconfiguredModels === true
             state.activeProfile = nextProfile
             // 📖 Rebuild favorites from profile data
             syncFavoriteFlags(state.results, state.config)
@@ -871,13 +994,33 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 📖 Interval adjustment keys: W=decrease (faster), ==increase (slower)
-    // 📖 X was previously used for interval increase but is now reserved for the log page overlay.
-    // 📖 Minimum 1s, maximum 60s
+    // 📖 W cycles the supported ping modes:
+    // 📖 speed (2s) → normal (10s) → slow (30s) → forced (4s) → speed.
+    // 📖 forced ignores auto speed/slow transitions until the user leaves it manually.
     if (key.name === 'w') {
-      state.pingInterval = Math.max(1000, state.pingInterval - 1000)
-    } else if (str === '=' || key.name === '=') {
-      state.pingInterval = Math.min(60000, state.pingInterval + 1000)
+      const currentIdx = PING_MODE_CYCLE.indexOf(state.pingMode)
+      const nextIdx = currentIdx >= 0 ? (currentIdx + 1) % PING_MODE_CYCLE.length : 0
+      setPingMode(PING_MODE_CYCLE[nextIdx], 'manual')
+    }
+
+    // 📖 E toggles hiding models whose provider has no configured API key.
+    // 📖 The preference is saved globally and mirrored into the active profile.
+    if (key.name === 'e') {
+      state.hideUnconfiguredModels = !state.hideUnconfiguredModels
+      if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
+      state.config.settings.hideUnconfiguredModels = state.hideUnconfiguredModels
+      if (state.activeProfile && state.config.profiles?.[state.activeProfile]) {
+        const profile = state.config.profiles[state.activeProfile]
+        if (!profile.settings || typeof profile.settings !== 'object') profile.settings = {}
+        profile.settings.hideUnconfiguredModels = state.hideUnconfiguredModels
+      }
+      saveConfig(state.config)
+      applyTierFilter()
+      const visible = state.results.filter(r => !r.hidden)
+      state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
+      state.cursor = 0
+      state.scrollOffset = 0
+      return
     }
 
     // 📖 Tier toggle key: T = cycle through each individual tier (All → S+ → S → A+ → A → A- → B+ → B → C → All)

package/src/overlays.js

@@ -105,6 +105,8 @@ export function createOverlayRenderers(state, deps) {
       let testBadge = chalk.dim('[Test —]')
       if (testResult === 'pending') testBadge = chalk.yellow('[Testing…]')
       else if (testResult === 'ok')   testBadge = chalk.greenBright('[Test ✅]')
+      else if (testResult === 'rate_limited') testBadge = chalk.yellow('[Rate limit ⏳]')
+      else if (testResult === 'no_callable_model') testBadge = chalk.magenta('[No model ⚠]')
       else if (testResult === 'fail') testBadge = chalk.red('[Test ❌]')
       const rateSummary = chalk.dim((meta.rateLimits || 'No limit info').slice(0, 36))
 
@@ -250,8 +252,8 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${chalk.cyan('Latest')}      Most recent ping response time (ms)  ${chalk.dim('Sort:')} ${chalk.yellow('L')}`)
     lines.push(`              ${chalk.dim('Shows how fast the server is responding right now — useful to catch live slowdowns.')}`)
     lines.push('')
-    lines.push(`  ${chalk.cyan('Avg Ping')}    Average response time across all successful pings (ms)  ${chalk.dim('Sort:')} ${chalk.yellow('A')}`)
-    lines.push(`              ${chalk.dim('The long-term truth. Ignore lucky one-off pings, this tells you real everyday speed.')}`)
+    lines.push(`  ${chalk.cyan('Avg Ping')}    Average response time across all measurable pings (200 + 401) (ms)  ${chalk.dim('Sort:')} ${chalk.yellow('A')}`)
+    lines.push(`              ${chalk.dim('The long-term truth. Even without a key, a 401 still gives real latency so the average stays useful.')}`)
     lines.push('')
     lines.push(`  ${chalk.cyan('Health')}      Live status: ✅ UP / 🔥 429 / ⏳ TIMEOUT / ❌ ERR / 🔑 NO KEY  ${chalk.dim('Sort:')} ${chalk.yellow('H')}`)
     lines.push(`              ${chalk.dim('Tells you instantly if a model is reachable or down — no guesswork needed.')}`)
@@ -278,10 +280,10 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${chalk.yellow('Enter')}        Select model and launch`)
     lines.push('')
     lines.push(`  ${chalk.bold('Controls')}`)
-    lines.push(`  ${chalk.yellow('W')}  Decrease ping interval (faster)`)
-    lines.push(`  ${chalk.yellow('=')}  Increase ping interval (slower)  ${chalk.dim('(was X — X is now the log page)')}`)
-    lines.push(`  ${chalk.yellow('X')}  Toggle request log page  ${chalk.dim('(shows recent requests from request-log.jsonl)')}`)
-    lines.push(`  ${chalk.yellow('Z')}  Cycle launch mode  ${chalk.dim('(OpenCode CLI → OpenCode Desktop → OpenClaw)')}`)
+    lines.push(`  ${chalk.yellow('W')}  Toggle ping mode  ${chalk.dim('(speed 2s → normal 10s → slow 30s → forced 4s)')}`)
+    lines.push(`  ${chalk.yellow('E')}  Toggle configured models only  ${chalk.dim('(enabled by default, persisted globally + in profiles)')}`)
+    lines.push(`  ${chalk.yellow('X')}  Toggle token log page  ${chalk.dim('(shows recent request usage from request-log.jsonl)')}`)
+    lines.push(`  ${chalk.yellow('Z')}  Cycle tool mode  ${chalk.dim('(OpenCode CLI → OpenCode Desktop → OpenClaw)')}`)
     lines.push(`  ${chalk.yellow('F')}  Toggle favorite on selected row  ${chalk.dim('(⭐ pinned at top, persisted)')}`)
     lines.push(`  ${chalk.yellow('Q')}  Smart Recommend  ${chalk.dim('(🎯 find the best model for your task — questionnaire + live analysis)')}`)
     lines.push(`  ${chalk.rgb(57, 255, 20).bold('J')}  Request Feature  ${chalk.dim('(📝 send anonymous feedback to the project team)')}`)
@@ -289,7 +291,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${chalk.yellow('P')}  Open settings  ${chalk.dim('(manage API keys, provider toggles, manual update)')}`)
     lines.push(`  ${chalk.yellow('Shift+P')}  Cycle config profile  ${chalk.dim('(switch between saved profiles live)')}`)
     lines.push(`  ${chalk.yellow('Shift+S')}  Save current config as a named profile  ${chalk.dim('(inline prompt — type name + Enter)')}`)
-    lines.push(`             ${chalk.dim('Profiles store: favorites, sort, tier filter, ping interval, API keys.')}`)
+    lines.push(`             ${chalk.dim('Profiles store: favorites, sort, tier filter, ping interval, configured-only filter, API keys.')}`)
     lines.push(`             ${chalk.dim('Use --profile <name> to load a profile on startup.')}`)
     lines.push(`  ${chalk.yellow('K')} / ${chalk.yellow('Esc')}  Show/hide this help`)
     lines.push(`  ${chalk.yellow('Ctrl+C')}  Exit`)

package/src/provider-metadata.js

@@ -77,140 +77,140 @@ export const OPENCODE_MODEL_MAP = {
 export const PROVIDER_METADATA = {
   nvidia: {
     label: 'NVIDIA NIM',
-    color: chalk.rgb(118, 185, 0),
+    color: chalk.rgb(178, 235, 190),
     signupUrl: 'https://build.nvidia.com',
     signupHint: 'Profile → API Keys → Generate',
     rateLimits: 'Free tier (provider quota by model)',
   },
   groq: {
     label: 'Groq',
-    color: chalk.rgb(249, 103, 20),
+    color: chalk.rgb(255, 204, 188),
     signupUrl: 'https://console.groq.com/keys',
     signupHint: 'API Keys → Create API Key',
     rateLimits: 'Free dev tier (provider quota)',
   },
   cerebras: {
     label: 'Cerebras',
-    color: chalk.rgb(0, 180, 255),
+    color: chalk.rgb(179, 229, 252),
     signupUrl: 'https://cloud.cerebras.ai',
     signupHint: 'API Keys → Create',
     rateLimits: 'Free dev tier (provider quota)',
   },
   sambanova: {
     label: 'SambaNova',
-    color: chalk.rgb(255, 165, 0),
+    color: chalk.rgb(255, 224, 178),
     signupUrl: 'https://cloud.sambanova.ai/apis',
     signupHint: 'SambaCloud portal → Create API key',
     rateLimits: 'Dev tier generous quota',
   },
   openrouter: {
     label: 'OpenRouter',
-    color: chalk.rgb(120, 80, 255),
+    color: chalk.rgb(225, 190, 231),
     signupUrl: 'https://openrouter.ai/keys',
     signupHint: 'API Keys → Create',
     rateLimits: '50 req/day, 20/min (:free shared quota)',
   },
   huggingface: {
     label: 'Hugging Face Inference',
-    color: chalk.rgb(255, 182, 0),
+    color: chalk.rgb(255, 245, 157),
     signupUrl: 'https://huggingface.co/settings/tokens',
     signupHint: 'Settings → Access Tokens',
     rateLimits: 'Free monthly credits (~$0.10)',
   },
   replicate: {
     label: 'Replicate',
-    color: chalk.rgb(120, 160, 255),
+    color: chalk.rgb(187, 222, 251),
     signupUrl: 'https://replicate.com/account/api-tokens',
     signupHint: 'Account → API Tokens',
     rateLimits: 'Developer free quota',
   },
   deepinfra: {
     label: 'DeepInfra',
-    color: chalk.rgb(0, 180, 140),
+    color: chalk.rgb(178, 223, 219),
     signupUrl: 'https://deepinfra.com/login',
     signupHint: 'Login → API keys',
     rateLimits: 'Free dev tier (low-latency quota)',
   },
   fireworks: {
     label: 'Fireworks AI',
-    color: chalk.rgb(255, 80, 50),
+    color: chalk.rgb(255, 205, 210),
     signupUrl: 'https://fireworks.ai',
     signupHint: 'Create account → Generate API key',
     rateLimits: '$1 free credits (new dev accounts)',
   },
   codestral: {
     label: 'Mistral Codestral',
-    color: chalk.rgb(255, 100, 100),
+    color: chalk.rgb(248, 187, 208),
     signupUrl: 'https://codestral.mistral.ai',
     signupHint: 'API Keys → Create',
     rateLimits: '30 req/min, 2000/day',
   },
   hyperbolic: {
     label: 'Hyperbolic',
-    color: chalk.rgb(0, 200, 150),
+    color: chalk.rgb(200, 230, 201),
     signupUrl: 'https://app.hyperbolic.ai/settings',
     signupHint: 'Settings → API Keys',
     rateLimits: '$1 free trial credits',
   },
   scaleway: {
     label: 'Scaleway',
-    color: chalk.rgb(130, 0, 250),
+    color: chalk.rgb(129, 212, 250),
     signupUrl: 'https://console.scaleway.com/iam/api-keys',
     signupHint: 'IAM → API Keys',
     rateLimits: '1M free tokens',
   },
   googleai: {
     label: 'Google AI Studio',
-    color: chalk.rgb(66, 133, 244),
+    color: chalk.rgb(187, 222, 251),
     signupUrl: 'https://aistudio.google.com/apikey',
     signupHint: 'Get API key',
     rateLimits: '14.4K req/day, 30/min',
   },
   siliconflow: {
     label: 'SiliconFlow',
-    color: chalk.rgb(255, 120, 30),
+    color: chalk.rgb(178, 235, 242),
     signupUrl: 'https://cloud.siliconflow.cn/account/ak',
     signupHint: 'API Keys → Create',
     rateLimits: 'Free models: usually 100 RPM, varies by model',
   },
   together: {
     label: 'Together AI',
-    color: chalk.rgb(0, 180, 255),
+    color: chalk.rgb(197, 225, 165),
     signupUrl: 'https://api.together.ai/settings/api-keys',
     signupHint: 'Settings → API keys',
     rateLimits: 'Credits/promos vary by account (check console)',
   },
   cloudflare: {
     label: 'Cloudflare Workers AI',
-    color: chalk.rgb(242, 119, 36),
+    color: chalk.rgb(255, 204, 128),
     signupUrl: 'https://dash.cloudflare.com',
     signupHint: 'Create AI API token + set CLOUDFLARE_ACCOUNT_ID',
     rateLimits: 'Free: 10k neurons/day, text-gen 300 RPM',
   },
   perplexity: {
     label: 'Perplexity API',
-    color: chalk.rgb(0, 210, 190),
+    color: chalk.rgb(159, 234, 201),
     signupUrl: 'https://www.perplexity.ai/settings/api',
     signupHint: 'Generate API key (billing may be required)',
     rateLimits: 'Tiered limits by spend (default ~50 RPM)',
   },
   qwen: {
     label: 'Alibaba Cloud (DashScope)',
-    color: chalk.rgb(255, 140, 0),
+    color: chalk.rgb(255, 224, 130),
     signupUrl: 'https://modelstudio.console.alibabacloud.com',
     signupHint: 'Model Studio → API Key → Create (1M free tokens, 90 days)',
     rateLimits: '1M free tokens per model (Singapore region, 90 days)',
   },
   zai: {
     label: 'ZAI (z.ai)',
-    color: chalk.rgb(0, 150, 255),
+    color: chalk.rgb(174, 213, 255),
     signupUrl: 'https://z.ai',
     signupHint: 'Sign up and generate an API key',
     rateLimits: 'Free tier (generous quota)',
   },
   iflow: {
     label: 'iFlow',
-    color: chalk.rgb(100, 200, 255),
+    color: chalk.rgb(220, 231, 117),
     signupUrl: 'https://platform.iflow.cn',
     signupHint: 'Register → Personal Information → Generate API Key (7-day expiry)',
     rateLimits: 'Free for individuals (no request limits)',