尧图网站建设 
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 的示例被一条Missing or empty required API keys in environment variables报错拦下多半不是代码问题而是密钥没进到当前进程的环境里。这篇笔记把 CAMEL 多模型 API 密钥配置拆成三步先跑通一次最小调用再讲透环境变量的临时/永久两种写法与 .env 方案最后给国内、国外各平台的变量名速览和一份看信号找原因的排错清单。读完你能独立完成任意平台的密钥配置和首次模型调用。零到第一次模型调用最小可运行路径整个流程三步拿代码、设变量、跑示例。以 OpenAI 为例git clone https://gitcode.com/GitHub_Trending/ca/camel cd camel pip install camel-ai export OPENAI_API_KEYsk-你的密钥然后在同一个终端里跑from camel.agents import ChatAgent from camel.models import ModelFactory from camel.types import ModelPlatformType, ModelType model ModelFactory.create( model_platformModelPlatformType.OPENAI, model_typeModelType.GPT_4O_MINI, ) agent ChatAgent(modelmodel) print(agent.step(用一句话介绍你自己).msgs[0].content)有输出就通了。背后的机制很直白ModelFactory.create按平台枚举找到对应的模型类模型实例化时由camel/utils/commons.py里的api_keys_required装饰器做校验——先看你在代码里显式传的api_key参数再查同名环境变量两者都没有才抛出上面那个报错。所以密钥有没有被读到这件事只有显式参数和环境变量两个入口。仓库里开箱即用的样例在 examples/models/比如 examples/models/openai_example.py 演示了多轮对话、工具调用和结构化输出换别的平台时改的只是ModelPlatformType、ModelType和对应环境变量骨架不变。密钥配好之后这类两智能体协作场景就只隔着一个step()调用的距离两种密钥配置方式临时 export 与永久化当前终端临时 export适合切换密钥试错export只对当前 shell 会话生效关掉窗口就没了。好处是随时换 key 不污染全局适合开发时对比两个账号、或者 CI 里一次性注入export DEEPSEEK_API_KEYsk-另一个密钥 python examples/models/deepseek_model_example.py注意变量必须和示例在同一个终端窗口里设置换了窗口就要重新 export。写进 shell 启动文件让密钥永久生效个人机器上推荐写进启动文件一次配置长期有效。Bash 用户追加到~/.bashrcmacOS 的 zsh 用户对应~/.zshrcecho export OPENAI_API_KEYsk-你的密钥 ~/.bashrc source ~/.bashrcWindows 用户走系统属性 → 高级 → 环境变量界面添加即可。改完后用echo $OPENAI_API_KEY验证当前会话确实能读到再跑示例。密钥放 .env 文件由代码负责加载不想动 shell 配置时把密钥放进项目根目录的.env文件每行变量名值、等号两边不留空格比如OPENAI_API_KEYsk-xxxx。代码里先加载再用from dotenv import load_dotenv from camel.configs import DeepSeekConfig from camel.models import ModelFactory from camel.types import ModelPlatformType, ModelType load_dotenv() model ModelFactory.create( model_platformModelPlatformType.DEEPSEEK, model_typeModelType.DEEPSEEK_V4_PRO, model_config_dictDeepSeekConfig(temperature0.3).as_dict(), )这里顺带说清 camel/configs/ 里那些 pydantic 配置类的分工它们管的是 temperature、max_tokens 这类采样参数api_key既可走环境变量也可以显式写进model_config_dict{api_key: ...}——显式参数优先级更高这正是前面校验器先查参数、再查环境变量的顺序。.env方案适合密钥不入库、但项目要可复现的场景前提是把.env加进.gitignore。多平台速览环境变量名与配置位置CAMEL 的平台支持集中在三处camel/models/是模型实现camel/configs/ 是各平台参数配置类examples/models/ 是每个平台一个的可运行示例。配任何新平台只需要记住它的环境变量名国内平台火山引擎豆包VOLCANO_API_KEY配置 camel/configs/volcano_config.py示例 examples/models/volcano_model_example.py阿里通义千问QWEN_API_KEY配置 camel/configs/qwen_config.py示例 examples/models/qwen_model_example.py智谱 AIZHIPUAI_API_KEY配置 camel/configs/zhipuai_config.py示例 examples/models/zhipuai_model_example.py百度千帆文心QIANFAN_API_KEY配置 camel/configs/qianfan_config.py示例 examples/models/ernie_model_example.pyMoonshotKimiMOONSHOT_API_KEY示例 examples/models/moonshot_model_example.pyInternLMINTERNLM_API_KEY零一万物YI_API_KEY国际平台OpenAIOPENAI_API_KEY配置类ChatGPTConfig在 camel/configs/openai_config.pyAzure OpenAIAZURE_OPENAI_API_KEYAnthropicClaudeANTHROPIC_API_KEY示例 examples/models/anthropic_model_example.pyDeepSeekDEEPSEEK_API_KEYGoogle GeminiGEMINI_API_KEYGroq / Mistral / Cohere / xAI / NVIDIA / Together分别对应GROQ_API_KEY、MISTRAL_API_KEY、COHERE_API_KEY、XAI_API_KEY、NVIDIA_API_KEY、TOGETHER_API_KEYOpenAI 兼容的第三方中转服务OPENAI_COMPATIBILITY_API_KEY走 OpenAI 兼容模型类base_url和api_key通过model_config_dict传入样例见 examples/models/openai_compatibility_model_examples/排错清单按错误信号定位看到Missing or empty required API keys in environment variables: OPENAI_API_KEY查什么先跑echo $OPENAI_API_KEY或printenv OPENAI_API_KEY确认变量在当前进程里。 常见原因export 是在另一个终端窗口做的改过~/.bashrc但没重新加载值前后带了空格或多余引号被校验逻辑当作空值。 怎么改在当前窗口重新 export 后运行示例改完启动文件记得source ~/.bashrc。看到官方返回 401 / invalid api key查什么密钥本身的状态以及平台和 key 是否配对。 常见原因密钥被禁用或余额耗尽把通义千问的 key 配了却把ModelPlatformType写成OPENAI。 怎么改到对应平台官网核对密钥状态确保平台枚举和 key 来源一一对应一个 key 只喂给一个平台。看到本地没报错、调用却始终 404 或超时查什么走的到底是不是你以为的端点。 常见原因调第三方 OpenAI 兼容服务却只设了OPENAI_API_KEY没设OPENAI_COMPATIBILITY_API_KEY也没传base_url。 怎么改参考兼容路线示例在model_config_dict里显式传base_url和api_key。看到平台或模型名无法识别查什么ModelPlatformType/ModelType的枚举值写法。 怎么改对照 camel/types/ 的枚举定义以及 examples/models/ 里同平台的示例抄准确写法。安全速记不硬编码api_key sk-xxx直接写进源码的重构时顺手挪到环境变量或.env不入库.env加进.gitignore提交前检查一遍 diff前后端隔离浏览器端拿不到 key统一由后端代理出请求按环境分 key开发、生产各发一把调用限额不同离职/换人时按把吊销定期回看官方控制台看用量和异常调用超限告警配起来下一步密钥配好之后往哪走examples/models/各平台的调用示例换平台基本就是抄骨架换枚举examples/models/model_manger.py用 ModelManager 在多模型之间动态切换多模型 API 密钥管理的进阶形态examples/agents/agents_share_modelmanager.py多个智能体共享同一模型管理器的写法docs/key_modules/models.md模型层的设计说明把前面零散的机制串成体系docs/get_started/setup.md 与 docs/get_started/installation.md环境搭建的官方入口【免费下载链接】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），仅供参考 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 的示例被一条Missing or empty required API keys in environment variables报错拦下多半不是代码问题而是密钥没进到当前进程的环境里。这篇笔记把 CAMEL 多模型 API 密钥配置拆成三步先跑通一次最小调用再讲透环境变量的临时/永久两种写法与 .env 方案最后给国内、国外各平台的变量名速览和一份看信号找原因的排错清单。读完你能独立完成任意平台的密钥配置和首次模型调用。零到第一次模型调用最小可运行路径整个流程三步拿代码、设变量、跑示例。以 OpenAI 为例git clone https://gitcode.com/GitHub_Trending/ca/camel cd camel pip install camel-ai export OPENAI_API_KEYsk-你的密钥然后在同一个终端里跑from camel.agents import ChatAgent from camel.models import ModelFactory from camel.types import ModelPlatformType, ModelType model ModelFactory.create( model_platformModelPlatformType.OPENAI, model_typeModelType.GPT_4O_MINI, ) agent ChatAgent(modelmodel) print(agent.step(用一句话介绍你自己).msgs[0].content)有输出就通了。背后的机制很直白ModelFactory.create按平台枚举找到对应的模型类模型实例化时由camel/utils/commons.py里的api_keys_required装饰器做校验——先看你在代码里显式传的api_key参数再查同名环境变量两者都没有才抛出上面那个报错。所以密钥有没有被读到这件事只有显式参数和环境变量两个入口。仓库里开箱即用的样例在 examples/models/比如 examples/models/openai_example.py 演示了多轮对话、工具调用和结构化输出换别的平台时改的只是ModelPlatformType、ModelType和对应环境变量骨架不变。密钥配好之后这类两智能体协作场景就只隔着一个step()调用的距离两种密钥配置方式临时 export 与永久化当前终端临时 export适合切换密钥试错export只对当前 shell 会话生效关掉窗口就没了。好处是随时换 key 不污染全局适合开发时对比两个账号、或者 CI 里一次性注入export DEEPSEEK_API_KEYsk-另一个密钥 python examples/models/deepseek_model_example.py注意变量必须和示例在同一个终端窗口里设置换了窗口就要重新 export。写进 shell 启动文件让密钥永久生效个人机器上推荐写进启动文件一次配置长期有效。Bash 用户追加到~/.bashrcmacOS 的 zsh 用户对应~/.zshrcecho export OPENAI_API_KEYsk-你的密钥 ~/.bashrc source ~/.bashrcWindows 用户走系统属性 → 高级 → 环境变量界面添加即可。改完后用echo $OPENAI_API_KEY验证当前会话确实能读到再跑示例。密钥放 .env 文件由代码负责加载不想动 shell 配置时把密钥放进项目根目录的.env文件每行变量名值、等号两边不留空格比如OPENAI_API_KEYsk-xxxx。代码里先加载再用from dotenv import load_dotenv from camel.configs import DeepSeekConfig from camel.models import ModelFactory from camel.types import ModelPlatformType, ModelType load_dotenv() model ModelFactory.create( model_platformModelPlatformType.DEEPSEEK, model_typeModelType.DEEPSEEK_V4_PRO, model_config_dictDeepSeekConfig(temperature0.3).as_dict(), )这里顺带说清 camel/configs/ 里那些 pydantic 配置类的分工它们管的是 temperature、max_tokens 这类采样参数api_key既可走环境变量也可以显式写进model_config_dict{api_key: ...}——显式参数优先级更高这正是前面校验器先查参数、再查环境变量的顺序。.env方案适合密钥不入库、但项目要可复现的场景前提是把.env加进.gitignore。多平台速览环境变量名与配置位置CAMEL 的平台支持集中在三处camel/models/是模型实现camel/configs/ 是各平台参数配置类examples/models/ 是每个平台一个的可运行示例。配任何新平台只需要记住它的环境变量名国内平台火山引擎豆包VOLCANO_API_KEY配置 camel/configs/volcano_config.py示例 examples/models/volcano_model_example.py阿里通义千问QWEN_API_KEY配置 camel/configs/qwen_config.py示例 examples/models/qwen_model_example.py智谱 AIZHIPUAI_API_KEY配置 camel/configs/zhipuai_config.py示例 examples/models/zhipuai_model_example.py百度千帆文心QIANFAN_API_KEY配置 camel/configs/qianfan_config.py示例 examples/models/ernie_model_example.pyMoonshotKimiMOONSHOT_API_KEY示例 examples/models/moonshot_model_example.pyInternLMINTERNLM_API_KEY零一万物YI_API_KEY国际平台OpenAIOPENAI_API_KEY配置类ChatGPTConfig在 camel/configs/openai_config.pyAzure OpenAIAZURE_OPENAI_API_KEYAnthropicClaudeANTHROPIC_API_KEY示例 examples/models/anthropic_model_example.pyDeepSeekDEEPSEEK_API_KEYGoogle GeminiGEMINI_API_KEYGroq / Mistral / Cohere / xAI / NVIDIA / Together分别对应GROQ_API_KEY、MISTRAL_API_KEY、COHERE_API_KEY、XAI_API_KEY、NVIDIA_API_KEY、TOGETHER_API_KEYOpenAI 兼容的第三方中转服务OPENAI_COMPATIBILITY_API_KEY走 OpenAI 兼容模型类base_url和api_key通过model_config_dict传入样例见 examples/models/openai_compatibility_model_examples/排错清单按错误信号定位看到Missing or empty required API keys in environment variables: OPENAI_API_KEY查什么先跑echo $OPENAI_API_KEY或printenv OPENAI_API_KEY确认变量在当前进程里。 常见原因export 是在另一个终端窗口做的改过~/.bashrc但没重新加载值前后带了空格或多余引号被校验逻辑当作空值。 怎么改在当前窗口重新 export 后运行示例改完启动文件记得source ~/.bashrc。看到官方返回 401 / invalid api key查什么密钥本身的状态以及平台和 key 是否配对。 常见原因密钥被禁用或余额耗尽把通义千问的 key 配了却把ModelPlatformType写成OPENAI。 怎么改到对应平台官网核对密钥状态确保平台枚举和 key 来源一一对应一个 key 只喂给一个平台。看到本地没报错、调用却始终 404 或超时查什么走的到底是不是你以为的端点。 常见原因调第三方 OpenAI 兼容服务却只设了OPENAI_API_KEY没设OPENAI_COMPATIBILITY_API_KEY也没传base_url。 怎么改参考兼容路线示例在model_config_dict里显式传base_url和api_key。看到平台或模型名无法识别查什么ModelPlatformType/ModelType的枚举值写法。 怎么改对照 camel/types/ 的枚举定义以及 examples/models/ 里同平台的示例抄准确写法。安全速记不硬编码api_key sk-xxx直接写进源码的重构时顺手挪到环境变量或.env不入库.env加进.gitignore提交前检查一遍 diff前后端隔离浏览器端拿不到 key统一由后端代理出请求按环境分 key开发、生产各发一把调用限额不同离职/换人时按把吊销定期回看官方控制台看用量和异常调用超限告警配起来下一步密钥配好之后往哪走examples/models/各平台的调用示例换平台基本就是抄骨架换枚举examples/models/model_manger.py用 ModelManager 在多模型之间动态切换多模型 API 密钥管理的进阶形态examples/agents/agents_share_modelmanager.py多个智能体共享同一模型管理器的写法docs/key_modules/models.md模型层的设计说明把前面零散的机制串成体系docs/get_started/setup.md 与 docs/get_started/installation.md环境搭建的官方入口【免费下载链接】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），仅供参考