uni-agent 设置-自定义key 智谱模型 环境变量怎么填写

欢迎到专业群（ uni-agent技术交流群 ） 咨询，群中有相关专业的管理员和群友。

针对您在 uni-agent 中配置自定义 Key 智谱模型报“余额不足”的问题，以下是排查与配置方案。

DCloud 账户订阅是官方推荐的模型连接方式，会自动获取 API 地址和密钥。但既然您明确要求使用自有智谱 API 密钥，可以通过手动配置环境变量来实现。

您遇到“余额不足”但自身秘钥余额充足的情况，最可能的原因是：在设置中没有真正切换到“自定义Key”模式，导致仍在使用 DCloud 账户订阅的智谱模型，消耗的是 DCloud 套餐余额。仅填写环境变量不代表已经切换了模型来源。

请按照以下步骤检查和配置：

1. 确认模型来源已切换
   在 uni-agent 聊天界面点击右上角“设置”，在“模型选择”中，必须明确切换到“自定义Key”选项，而不是选择“智谱”（选择“智谱”属于 DCloud 账户订阅模式）。

2. 填写环境变量
   切换到“自定义Key”后，在编辑器中使用 KEY=VALUE 格式填写环境变量，每行一个，以 # 开头的行为注释。环境变量名必须严格注意大小写，全部使用大写。
   智谱通常提供兼容 OpenAI 的接口，您可以将 UNI_AGENT_PROVIDER 配置为 openai-compatible，并参考智谱官方文档填写其兼容接口的 API 地址和模型名称。配置示例如下：

# uni-agent 配置  
UNI_AGENT_BASE_URL=智谱官方提供的兼容接口API地址  
UNI_AGENT_API_KEY=您的智谱API密钥  
UNI_AGENT_PROVIDER=openai-compatible  
UNI_AGENT_MODEL=openai-compatible/智谱对应的模型名称  
UNI_AGENT_SMALL_FAST_MODEL=openai-compatible/智谱对应的小模型名称

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

如果需要声明上下文窗口大小，可以额外填写 UNI_AGENT_MODEL_CONTEXT_WINDOW。

1. 保存并生效
   点击保存后，环境变量配置会存储在插件的全局存储中。建议重新初始化或重启 uni-agent，以确保新的配置生效。

如果确认已切换到“自定义Key”且配置无误，但仍报余额不足，请检查 UNI_AGENT_BASE_URL 和 UNI_AGENT_MODEL 是否填写正确，避免因地址或模型名错误导致请求被拦截或计费异常。

同时提醒，uni-agent 的内置技能、知识库、项目分析和调度策略主要围绕自带模型进行适配和验证，改用自定义 Key 或其他模型后，实际效果可能发生变化。在数据安全方面，使用自定义 Key 时，您的代码逻辑和各种密钥信息会直接发送给对应的模型服务商，请注意相关风险。