Atoms多模型同时调用鉴权参数设置方法

调用Atoms多模型时，需为每个模型配置独立且有效的鉴权凭证，否则会触发401错误。应在atoms-config.yaml中为各provider设置唯一ID、auth_type以及对应的密钥或token字段，并支持ENV_VAR或dotenv方式安全注入。对于私有模型，还需启用HMAC签名，并确保secret与算法严格匹配。

理解Atoms多模型调用的鉴权前提

Atoms框架允许同时向多个大模型（如OpenAI、Anthropic、Ollama）发起并行请求。不过，每个模型调用都必须附带独立且有效的鉴权凭证，否则将触发401错误或被网关拦截。这就要求在配置阶段为每个模型实例明确指定其专属的认证参数，而不能共用一套密钥。

在Atoms配置文件中设置多模型鉴权参数

打开项目根目录下的 atoms-config.yaml 文件，定位到

节点。每个模型提供者必须以唯一ID声明，并在其下嵌套完整鉴权字段：

① 在

下为每个模型创建独立区块，ID不可重复（例如 和 ）；

② 每个区块内必须包含

字段，值仅可为 或 ；

③ 若

，则必须提供 字段，且该值不能为空字符串或纯空格——Atoms启动时会校验此项，；

④ 若

，则必须同时提供 和 （如 Bearer、OAuth2），缺一不可。

通过环境变量注入敏感鉴权信息

方法一：使用

占位符

在 atoms-config.yaml 中直接写：api_key: "${OPENAI_API_KEY}"。Atoms运行时自动从系统环境变量读取值。此方式避免密钥硬编码，适合CI/CD流程。

方法二：启用 dotenv 支持

在项目根目录新建 .env 文件，写入：ANTHROPIC_API_KEY=sk-ant-xxx。Atoms默认加载该文件，无需额外配置——但注意，

。

为不同模型设置差异化签名策略

当调用支持 HMAC 签名的私有模型服务（如自建 LLaMA API 网关）时，需在 provider 配置中启用签名：

添加

；

指定

——该值必须与后端服务约定的密钥完全一致，大小写敏感；

设置

为 或 ，不支持 MD5；

若未配置

字段，Atoms 默认使用 头发送毫秒级时间戳，后端须据此校验请求时效性（建议窗口 ≤ 300 秒）。