分组 default 下模型 gemini-3.6-flash 无可用渠道（distributor） (request id: 2026072509385983...

2026年07月25日 17:44 29.95 秒 success

错误信息

AI_APICallError: 分组 default 下模型 gemini-3.6-flash 无可用渠道（distributor） (request id: 20260725093859833531327c14228f5FAQ5QofX) at file:///D:/cherry%20studio/resources/app.asar/out/renderer/assets/store-SasHqsyc.js:52078:11 at async postToApi$2 (file:///D:/cherry%20studio/resources/app.asar/out/renderer/assets/store-SasHqsyc.js:51973:24) at async OpenAICompatibleChatLanguageModel.doStream (file:///D:/cherry%20studio/resources/app.asar/out/renderer/assets/store-SasHqsyc.js:69973:48) at async wrapStream (file:///D:/cherry%20studio/resources/app.asar/out/renderer/assets/store-SasHqsyc.js:105783:32) at async fn (file:///D:/cherry%20studio/resources/app.asar/out/renderer/assets/store-SasHqsyc.js:104433:17) at async file:///D:/cherry%20studio/resources/app.asar/out/renderer/assets/store-SasHqsyc.js:100704:19 at async _retryWithExponentialBackoff (file:///D:/cherry%20studio/resources/app.asar/out/renderer/assets/store-SasHqsyc.js:100894:10) at async streamStep (file:///D:/cherry%20studio/resources/app.asar/out/renderer/assets/store-SasHqsyc.js:104402:109) at async fn (file:///D:/cherry%20studio/resources/app.asar/out/renderer/assets/store-SasHqsyc.js:104719:5) at async file:///D:/cherry%20studio/resources/app.asar/out/renderer/assets/store-SasHqsyc.js:100704:19

AI 解决方案

🔍 报错分析

1. 🌐 错误翻译

原文：AI_APICallError: 分组 default 下模型 gemini-3.6-flash 无可用渠道（distributor） (request id: 20260725093859833531327c14228f5FAQ5QofX)
译文：AI_API调用错误：在 default 分组下，模型 gemini-3.6-flash 没有可用的分发渠道（distributor）

2. 🎯 原因分析

该错误的核心原因是API配置缺失。具体表现为：

系统尝试调用 gemini-3.6-flash 模型，但找不到可用的分发渠道

分发渠道（distributor）通常指API密钥的配置或代理转发节点

错误发生在调用第三方AI服务时，表明当前环境未正确配置该模型的访问凭证或接入点

3. 💡 解决方案

需要检查并补充模型分发渠道的配置。以下是配置修复示例：

// 补充缺失的模型分发渠道配置
const modelConfig = {
  group: 'default',
  models: {
    'gemini-3.6-flash': {
      // 补充可用的API分发渠道
      distributor: {
        type: 'gemini-api', // 指定分发类型
        apiKey: 'YOUR_GEMINI_API_KEY', // 填入有效的API密钥
        baseUrl: 'https://generativelanguage.googleapis.com/v1beta/openai' // Gemini API接入点
      }
    }
  }
};

// 确保配置生效后重新初始化模型
initializeModelService(modelConfig);

若为已封装的应用（如Cherry Studio），需在应用配置界面补充对应的API密钥或分发渠道信息。

4. 🛡️ 预防措施

预校验配置完整性：开发或部署前，编写校验脚本检查所有配置的模型是否有对应的分发渠道，避免启动后才发现缺失。

配置动态管理：搭建配置中心或在应用中提供可视化的配置管理入口，方便快速修改、补充分发渠道，无需修改代码重新部署。

使用配置校验工具：推荐使用 schema 校验工具（如 ajv）对配置进行格式和完整性校验，提前暴露缺失项。

分析新问题查看更多