如何添加百炼的API Key到环境变量中 - 大模型服务平台百炼

建议您把API Key配置到环境变量，从而避免在代码里显式地配置API Key，降低泄漏风险。

操作步骤

Linux系统

添加永久性环境变量

如果您希望API Key环境变量在当前用户的所有新会话中生效，可以添加永久性环境变量。

执行以下命令来将环境变量设置追加到~/.bashrc 文件中。
```
# 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bashrc
```
也可以手动修改~/.bashrc 文件。
手动修改
执行以下命令，打开~/.bashrc 文件。
```
nano ~/.bashrc
```
在配置文件中添加以下内容。
```
# 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
```
在nano编辑器中，按Ctrl + X，接着按Y，再按Enter以保存并关闭文件。
执行以下命令，使变更生效。
```
source ~/.bashrc
```
重新打开一个终端窗口，运行以下命令检查环境变量是否生效。
```
echo $DASHSCOPE_API_KEY
```

添加临时性环境变量

如果您仅希望在当前会话中使用该环境变量，可以添加临时性环境变量。

执行以下命令。

# 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

执行以下命令，验证该环境变量是否生效。
```
echo $DASHSCOPE_API_KEY
```

macOS系统

添加永久性环境变量

如果您希望API Key环境变量在当前用户的所有新会话中生效，可以添加永久性环境变量。

在终端中执行以下命令，查看默认Shell类型。
```
echo $SHELL
```
根据默认Shell类型进行操作。
Zsh
1. 执行以下命令来将环境变量设置追加到 ~/.zshrc 文件中。
```
# 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc
```
  也可以手动修改~/.zshrc 文件。
  手动修改
  执行以下命令，打开Shell配置文件。
  nano ~/.zshrc
  在配置文件中添加以下内容。
  # 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  在nano编辑器中，按Ctrl + X，接着按Y，再按Enter以保存并关闭文件。
2. 执行以下命令，使变更生效。
```
source ~/.zshrc
```
3. 重新打开一个终端窗口，运行以下命令检查环境变量是否生效。
```
echo $DASHSCOPE_API_KEY
```
Bash
1. 执行以下命令来将环境变量设置追加到 ~/.bash_profile 文件中。
```
# 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile
```
  也可以手动修改~/.bash_profile 文件。
  手动修改
  执行以下命令，打开Shell配置文件。
  nano ~/.bash_profile
  在配置文件中添加以下内容。
  # 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  在nano编辑器中，按Ctrl + X，接着按Y，再按Enter以保存并关闭文件。
2. 执行以下命令，使变更生效。
```
source ~/.bash_profile
```
3. 重新打开一个终端窗口，运行以下命令检查环境变量是否生效。
```
echo $DASHSCOPE_API_KEY
```

添加临时性环境变量

如果您仅希望在当前会话中使用该环境变量，可以添加临时性环境变量。

执行以下命令。

# 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

执行以下命令，验证该环境变量是否生效。
```
echo $DASHSCOPE_API_KEY
```

Windows系统

在Windows系统中，您可以使用CMD或PowerShell运行命令。

CMD

添加永久性环境变量

如果您希望API Key环境变量在当前用户的所有新会话中生效，可以按如下操作。

在CMD中运行以下命令。

# 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY
setx DASHSCOPE_API_KEY "YOUR_DASHSCOPE_API_KEY"

打开一个新的CMD窗口。
在新的CMD窗口运行以下命令，检查环境变量是否生效。
```
echo %DASHSCOPE_API_KEY%
```

添加临时性环境变量

如果您仅希望在当前会话中使用该环境变量，可以在CMD中运行以下命令。

# 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY
set DASHSCOPE_API_KEY=YOUR_DASHSCOPE_API_KEY

您可以在当前会话运行以下命令检查环境变量是否生效。

echo %DASHSCOPE_API_KEY%

PowerShell

添加永久性环境变量

如果您希望API Key环境变量在当前用户的所有新会话中生效，可以按如下操作。

在PowerShell中运行以下命令。

# 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY
[Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)

打开一个新的PowerShell窗口。
在新的PowerShell窗口运行以下命令，检查环境变量是否生效。
```
echo $env:DASHSCOPE_API_KEY
```

添加临时性环境变量

如果您仅希望在当前会话中使用该环境变量，可以在PowerShell中运行以下命令。

# 用您的 DashScope API Key 代替 YOUR_DASHSCOPE_API_KEY
$env:DASHSCOPE_API_KEY = "YOUR_DASHSCOPE_API_KEY"

您可以在当前会话运行以下命令检查环境变量是否生效。

echo $env:DASHSCOPE_API_KEY

常见问题

Q：用echo命令确认环境变量设置成功了，为什么运行代码还是提示找不到API Key？

情况一：通常需要重启IDE（如VS Code）或命令行工具，使其能够加载最新的环境变量。
情况二：如果在部署应用后设置了环境变量，可能需要重启应用服务，让应用能够重新加载环境变量。
情况三：如果您的应用是通过服务管理器（如systemd、supervisord）启动的，可能需要在服务管理器的配置文件中添加环境变量。
情况四：如果使用sudo python xx.py运行脚本，可能会遗漏当前用户环境变量，因为sudo默认不继承所有环境变量。您可采用sudo -E python xx.py命令，其中的-E 参数确保环境变量被传递。如有权限执行该脚本，可以直接执行 python xx.py。

操作步骤

Linux系统

添加永久性环境变量

添加临时性环境变量

macOS系统

添加永久性环境变量

Zsh

Bash

添加临时性环境变量

Windows系统

CMD

添加永久性环境变量

添加临时性环境变量

PowerShell

添加永久性环境变量

添加临时性环境变量

常见问题