必须将API_KEY配置为系统级环境变量METASO_API_KEY，否则每次调用需硬编码或手动传参，既不安全也不可维护；Windows可通过系统属性或PowerShell设置，macOS/Linux需在shell配置文件中添加export声明并source生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在本地开发环境中让秘塔AI搜索的SDK或自研程序自动读取API密钥，必须将API_KEY配置为系统级环境变量，否则每次调用都要硬编码或手动传参，既不安全也不可维护。
获取并验证你的API Key
登录秘塔AI搜索管理后台 → 点击右上角头像 → 进入「API密钥管理」页面 → 确认状态为「已启用」且未过期。若无密钥，点击「创建新密钥」生成一个；【生成后务必立即复制保存，页面刷新后无法再次查看明文】。
Windows系统配置方法
方法一：图形界面设置
右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→ 在「系统变量」区域点击「新建」→ 变量名填 METASO_API_KEY，变量值粘贴你刚复制的密钥字符串 → 点击「确定」保存。
方法二：PowerShell临时生效（仅当前窗口）
在 PowerShell 中执行：$env:METASO_API_KEY="sk-xxx"（把 sk-xxx 替换为你的真实密钥）→ 这一步操作起来很简单，但关闭窗口即失效，仅适合调试。
macOS / Linux系统配置方法
第一步：确认你的shell类型
终端中执行 echo $SHELL，常见返回为 /bin/zsh（macOS Catalina 及以后默认）或 /bin/bash。
第二步：编辑对应配置文件
若为 zsh：执行 nano ~/.zshrc；若为 bash：执行 nano ~/.bash_profile 或 nano ~/.bashrc。
第三步：追加环境变量声明
在文件末尾新增一行：export METASO_API_KEY="sk-xxx"（注意引号必须是英文双引号，sk-xxx 替换为你的密钥）→ 【不要漏掉 export 关键字，否则变量不会被子进程继承】。
第四步：使配置立即生效
执行 source ~/.zshrc（或对应文件名）→ 此时该终端已加载新变量。
第五步：验证是否成功
执行 echo $METASO_API_KEY，应完整输出你的密钥；再执行 python3 -c "import os; print(os.getenv('METASO_API_KEY') is not None)"，输出 True 即表示Python运行时也能正确读取。
