以下是关于如何获取阿里云 DashScope API 密钥并配置环境变量的详细指南。DashScope 是阿里云提供的大模型服务平台，用于调用各种 AI 模型（如文本生成、图像识别等）。API 密钥（DASHSCOPE_API_KEY）是身份验证的必备凭证，环境变量配置则确保密钥在代码中安全使用。本指南基于阿里云官方文档，步骤清晰可靠，请按顺序操作。

步骤 1：获取阿里云 DashScope API 密钥

要调用 DashScope 模型，您需要先在阿里云控制台创建并获取 API 密钥。以下是详细步骤：

1. 登录阿里云控制台：

   • 访问 阿里云官网。
   • 使用您的阿里云账号登录（如果没有账号，需先注册）。
   • 登录后，进入控制台首页。

2. 导航到 DashScope 服务：

   • 在控制台搜索框中输入“DashScope”或“灵积”（DashScope 的中文名）。
   • 点击进入“DashScope”服务页面。
   • 如果您是首次使用，需开通服务（通常免费试用，但需实名认证）。

3. 创建 API 密钥：

   • 在 DashScope 控制台，找到“API 密钥管理”或“AccessKey”选项。
   • 点击“创建 AccessKey”，系统会生成一对密钥：AccessKey ID 和 AccessKey Secret。
   • 重要：AccessKey Secret 就是您的 DASHSCOPE_API_KEY。请立即复制并保存到安全位置（如密码管理器），因为它只显示一次，丢失后需重新生成。
   • 确保密钥权限已绑定到 DashScope 服务（默认自动绑定）。

完成此步骤后，您将获得类似以下的密钥：

• AccessKey ID: LTAI5t**********（示例）
• DASHSCOPE_API_KEY: nR2**********（示例，实际为 AccessKey Secret）

步骤 2：配置环境变量

环境变量让您的代码安全读取 API 密钥，避免硬编码在脚本中。配置方法因操作系统而异，以下是常见系统的步骤：

在 Linux/macOS 系统配置

1. 打开终端：

   • 使用命令行工具（如 Terminal）。

2. 设置临时环境变量（适用于当前会话）：

   • 输入命令：

     export DASHSCOPE_API_KEY="您的_AccessKey_Secret"
     

     • 替换 您的_AccessKey_Secret 为步骤 1 中获取的实际密钥。
   • 验证是否设置成功：

     echo $DASHSCOPE_API_KEY
     

     • 如果输出密钥内容，表示配置成功。

3. 设置永久环境变量（推荐）：

   • 编辑用户配置文件（如 ~/.bashrc 或 ~/.zshrc）：

     nano ~/.bashrc  # 使用文本编辑器打开
     

   • 在文件末尾添加：

     export DASHSCOPE_API_KEY="您的_AccessKey_Secret"
     

   • 保存文件并退出编辑器（在 nano 中按 Ctrl+X，然后 Y 确认）。
   • 使配置生效：

     source ~/.bashrc
     

在 Windows 系统配置

1. 打开系统设置：

   • 右键点击“此电脑”或“我的电脑”，选择“属性”。
   • 进入“高级系统设置” > “环境变量”。

2. 设置用户变量：

   • 在“用户变量”部分，点击“新建”。
   • 变量名输入 DASHSCOPE_API_KEY。
   • 变量值输入您的 AccessKey Secret（从步骤 1 获取）。
   • 点击“确定”保存。

3. 验证配置：

   • 打开命令提示符（CMD）或 PowerShell。
   • 输入：

     echo %DASHSCOPE_API_KEY%
     

     • 或在 PowerShell 中：

       $env:DASHSCOPE_API_KEY
       

     • 如果输出密钥内容，表示配置成功。

步骤 3：验证并测试配置

配置完成后，建议测试 API 密钥是否有效。以下是一个简单的 Python 示例，使用 dashscope 库调用模型（需先安装库）：

• 安装依赖：

  pip install dashscope
  

• Python 测试代码：

  import os
  import dashscope
  
  # 从环境变量读取 API 密钥
  api_key = os.getenv('DASHSCOPE_API_KEY')
  if not api_key:
      raise ValueError("DASHSCOPE_API_KEY 未设置！请检查环境变量。")
  
  dashscope.api_key = api_key  # 设置密钥
  
  # 调用一个简单模型（例如文本生成）
  response = dashscope.Generation.call(
      model='qwen-turbo',  # 使用通义千问模型
      prompt='你好，世界'
  )
  print(response.output.text)  # 输出模型响应
  

  • 运行此脚本，如果返回模型输出（如“你好！”），则表示配置成功。

注意事项

• 安全提示：API 密钥相当于密码，切勿泄露或上传到公共仓库（如 GitHub）。使用环境变量是安全最佳实践。
• 问题排查：
  • 如果环境变量未生效，重启终端或系统。
  • 确保密钥正确：在 DashScope 控制台检查密钥状态（如是否启用）。
• 更多资源：参考 阿里云 DashScope 文档 获取详细 API 使用指南。

按照以上步骤操作，您即可顺利完成配置。如有其他问题，欢迎提供更多细节！