CAMEL多模型API密钥配置完整教程：从零到跑通

CAMEL多模型API密钥配置完整教程从零到跑通【免费下载链接】camel CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org项目地址: https://gitcode.com/GitHub_Trending/ca/camel开头运行第一个 CAMEL 示例时很多人卡在同一个报错KeyError: DEEPSEEK_API_KEY。密钥没找到程序直接崩了而仓库里 40 多个平台的密钥变量名各不相同很容易混淆。这篇 CAMEL 多模型 API 密钥配置教程从报错讲起先 5 分钟跑通一次模型调用再教你把密钥、参数、多平台配置一次配齐全程约 15 分钟。快速体验5分钟跑通一次模型调用先装好 CAMEL源码安装或 pip 安装均可git clone https://gitcode.com/GitHub_Trending/ca/camel cd camel pip install camel-ai # 或使用 uv sync --all-extras 从源码安装然后设置 DeepSeek 的密钥环境变量并运行最小示例export DEEPSEEK_API_KEYsk-你的密钥from camel.models import ModelFactory from camel.types import ModelPlatformType, ModelType model ModelFactory.create( model_platformModelPlatformType.DEEPSEEK, model_typeModelType.DEEPSEEK_CHAT, ) resp, _ model.run(prompt用一句话介绍 CAMEL 框架) print(resp.messages[0].msg.content)预期输出类似CAMEL 是一个用于构建和研究多智能体协作的开源框架。能打印出模型回复说明密钥链路已完全打通。环境与项目结构CAMEL 的密钥逻辑分布在三处camel/configs/定义各平台可传哪些参数camel/models/决定从哪个环境变量读密钥examples/models/提供 80 个真实调用样例。camel/ ├── configs/ │ ├── base_config.py # 所有配置类的基类 │ ├── openai_config.py # ChatGPTConfig │ ├── deepseek_config.py # DeepSeekConfig │ ├── qwen_config.py # QwenConfig │ └── volcano_config.py # VolcanoConfig ├── models/ │ ├── model_factory.py # 统一入口 ModelFactory │ └── deepseek_model.py # 读取 DEEPSEEK_API_KEY └── types/ └── enums.py # ModelPlatformType / ModelType 枚举设置各平台密钥环境变量密钥本质上就是程序随身带的一把钥匙放在环境变量里不进代码、不怕误提交。CAMEL 各平台模型类都会自动读取对应的环境变量下面是主流平台对照表变量名均在camel/models/中核实平台环境变量密钥示例配置文件OpenAIOPENAI_API_KEYsk-...openai_config.pyAnthropicANTHROPIC_API_KEYsk-ant-...anthropic_config.pyDeepSeekDEEPSEEK_API_KEYsk-...deepseek_config.py阿里通义千问QWEN_API_KEY百炼 API Keyqwen_config.py火山引擎VOLCANO_API_KEYak-...volcano_config.py临时生效仅当前终端export OPENAI_API_KEYsk-你的密钥 export DEEPSEEK_API_KEYsk-你的密钥想永久生效把同样的export行追加到~/.bashrcmacOS 用~/.zshrc后执行source刷新。CAMEL 也支持.env文件把仓库里的.env.example复制为.env再填入密钥即可记得把.env加入.gitignore。变量名配对完成后下一步是把生成参数从代码里抽出来。写入自定义配置参数密钥解决能不能调参数解决怎么调。camel/configs/下每个平台有一个配置类字段即该 API 支持的全部参数。以 DeepSeek 为例DeepSeekConfig支持temperature、top_p、max_tokens、response_format、reasoning_effort、thinking等完整字段列表看类定义里的 Args 说明即可。from camel.configs import DeepSeekConfig # 只写需要覆盖的参数其余走默认值 config DeepSeekConfig( temperature0.7, max_tokens2048, )注意配置类基于 Pydantic 且extraforbid拼错字段名会直接报 ValidationError拼对了也方便——报错就是防呆机制。参数对象只是随身参数表下一步把它交给工厂创建模型实例。显式传递密钥创建模型实例上两步解决了密钥来源和参数组织这一步把它们组合起来。ModelFactory.create()的签名里除了model_config_dict还直接接受api_key、url、timeout、max_retries参数model ModelFactory.create( model_platformModelPlatformType.DEEPSEEK, model_typeModelType.DEEPSEEK_CHAT, model_config_dictconfig, # 传入上一步的配置对象 api_keysk-你的密钥, # 可选显式传密钥优先于环境变量 timeout60, # 可选超时秒数 )规则很简单传了api_key就用你给的不传就回落到对应环境变量。团队协作时建议优先用环境变量显式传参只留给测试脚本。多平台并行使用时同一个工厂能创建任意多个不同平台的实例gpt ModelFactory.create( model_platformModelPlatformType.OPENAI, model_typeModelType.GPT_4O, model_config_dict{temperature: 0.7}, ) deepseek ModelFactory.create( model_platformModelPlatformType.DEEPSEEK, model_typeModelType.DEEPSEEK_CHAT, ) r1, _ gpt.run(prompt介绍 CAMEL 的核心优势) r2, _ deepseek.run(prompt分析多智能体协作的趋势) print(r1.messages[0].msg.content) print(r2.messages[0].msg.content)两个实例互不干扰各读各的密钥。进阶用 YAML 管理多模型配置高频进阶点有两个配置对象是冻结的。BaseConfig声明了frozenTrue创建后不能修改属性想换参数就重新构造一个再传入create()。批量管理用 YAML。工厂提供create_from_yaml()和create_from_json()可以把平台 模型 参数写进一个 YAML 文件按文件批量创建模型适合多模型对比或团队共享配置。想继续了解模型在多智能体体系中的位置可以看 docs/key_modules/models.md。安全与避坑记三组口诀三不不硬编码密钥写进代码一旦提交仓库就永久泄露。不入版本库.env不加入.gitignore一次git add .就能带走你的密钥。不用共享密钥团队共用一把钥匙出了异常调用难以定位到人。三做做环境隔离开发、生产用不同密钥生产密钥可随时单独吊销。做定期轮换密钥有泄露窗口期轮换把损失控制在窗口内。做用量监控登录各平台后台核对调用量突增往往是密钥被盗用的信号。常见问题Q1报KeyError: XXX_API_KEY结论环境变量没设或名字拼错。先echo $DEEPSEEK_API_KEY确认有值再核对上面对照表变量名和平台一一对应QWEN_API_KEY不是DASHSCOPE_API_KEY以 camel/models/ 里各模型类的读取逻辑为准。Q2ValidationError字段不被允许结论配置类extraforbid你传了该平台不支持的参数。对照 camel/configs/ 对应文件的字段定义删掉多余参数即可。Q3AuthenticationError/ 401结论密钥有效但权限或额度有问题。到对应平台控制台检查密钥状态与计费额度注意不同平台密钥前缀不同如 Anthropic 是sk-ant-前缀异常一般是复制错了。Q4.env文件没有自动生效结论.env依赖 pydantic-settings 的自动加载需要pip install python-dotenv后生效不放心就在代码里显式load_dotenv()或在 shell 里直接export。收尾到这里你已经完成环境变量配密钥、配置类管参数、工厂建实例、多平台共存四条链路全部跑通。想继续深入建议按顺序看docs/key_modules/models.md模型模块设计、examples/models/deepseek_model_example.py带工具调用的完整示例、camel/models/model_factory.py工厂全部参数与 YAML/JSON 加载逻辑。【免费下载链接】camel CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org项目地址: https://gitcode.com/GitHub_Trending/ca/camel创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考