天极下载
安装好LobsterAI后，如果发送任务时提示没有可用模型、密钥无效或连接失败，一般不是客户端安装出了问题，而是模型服务还没有配置完整。把API Key、接口地址和模型名称对应起来，保存后再给智能体选中该模型，任务才能正常开始。
LobsterAI大模型配置入口在哪里
1.进入模型设置页面
●打开LobsterAI的设置页面，找到模型或模型服务商栏目。这里用于管理模型提供商、API Key、接口地址、API格式和可用模型。
●已经配置过多个服务商时，应先点开需要使用的那一个。只在列表中看到服务商名称，并不代表该服务商已经启用。
2.选择预置或自定义服务商
●使用LobsterAI已经列出的服务商时，可以直接选择对应入口，再填写该平台生成的API Key。预置配置通常会带出默认接口地址，普通用户不需要自行修改。
●使用兼容接口、私有网关或其他模型平台时，可以添加自定义服务商。此时除了API Key，还要根据接口文档填写API Base URL、API格式和准确的模型名称。
3.给智能体选择可用模型
●服务商配置完成后，还要检查当前智能体使用的是哪个模型。LobsterAI支持为不同智能体分别设置模型，修改服务商不一定会自动替换原有智能体的选择。
●新建任务前确认输入区域或智能体设置中已经选中目标模型。如果仍然显示旧模型，可以切换一次模型，或者新建会话后重新测试。
LobsterAI API Key应该怎么填写
1.从模型服务商获取密钥
●API Key需要在所使用的模型服务商控制台中创建，不是LobsterAI的登录密码。部分平台只会在创建时完整显示一次密钥，复制后应妥善保存。
●粘贴密钥时不要加引号、中文括号或说明文字，首尾也不要留空格。账号下存在多个项目时，还要确认密钥属于已经开通模型服务和计费权限的项目。
2.核对API Base URL和接口格式
●使用预置服务商时，API Base URL保持默认值通常更稳。只有接入自定义网关、代理服务或兼容接口时，才需要按照对方说明修改地址。
●接口格式不能只根据模型名称判断。服务商要求使用OpenAI兼容格式时，应选择对应格式；使用其他协议时，也要匹配服务商给出的调用规范。
●Base URL多写或少写一段路径，都可能出现404错误。不要直接复制浏览器中的模型控制台网址，控制台页面地址通常不是API调用地址。
3.添加模型并测试连接
●模型名称要填写服务商实际开放的模型ID，字母、数字、连字符和版本后缀都要保持一致。显示名称可以自定义，模型ID则不能随意简写。
●填写完成后执行连接测试。测试通过后保存配置、打开服务商启用开关，再把模型分配给当前智能体。
●连接测试只验证当前配置能否发起请求，不代表账号一直有可用额度。正式使用前还要查看模型平台的余额、调用限额和区域限制。
LobsterAI模型连接失败怎么排查
1.提示401或密钥无效
●重新复制API Key，检查是否粘贴了多余空格，或者误用了其他平台的密钥。密钥被删除、过期或重置后，LobsterAI中保存的旧值也会失效。
●确认模型服务已经在对应账号和项目下开通。有些平台的控制台账号可以正常登录，但没有API调用权限，依然会返回鉴权失败。
2.提示404或找不到模型
●重点核对API Base URL和模型ID。接口地址能够打开，不代表路径适合模型调用；模型在网页端可见，也不代表API账户已经获得相同权限。
●使用自定义服务时，检查接口末尾是否需要保留版本路径，同时确认LobsterAI选择的API格式与服务端一致。
3.提示429或请求次数过多
●429通常与余额不足、并发限制、每分钟调用次数或Token额度有关。减少同时运行的任务，等待限流窗口结束，再到服务商后台查看用量。
●长文档、批量文件和多智能体任务会消耗更多额度。测试阶段可以先用一小段文字验证连接，不要直接提交整个资料文件夹。
4.测试通过但任务仍然失败
●检查当前会话绑定的模型，避免出现服务商配置已经更新、智能体仍在使用旧模型的情况。切换模型或新建会话后再发送一条短指令进行验证。
●排查电脑代理、防火墙、证书拦截和网络波动。企业网络如果限制外部API域名，需要由网络管理员放行对应地址。
●LobsterAI会在本地保存应用配置和会话数据，但使用云端模型时，请求内容仍需发送给所选服务商处理。本地保存不等于本地推理，涉及敏感文件时应同时查看模型平台的数据规则。
