阿里云 DashScope API 密钥获取与配置指南

一、获取 DASHSCOPE_API_KEY

1. 登录阿里云控制台
   访问 阿里云官网 → 登录您的账号

2. 进入 DashScope 服务

   • 控制台搜索栏输入 "DashScope" → 进入服务页面
   • 首次使用需开通服务（免费额度可用）

3. 创建 API 密钥

   1. 左侧菜单选择「API密钥管理」
   2. 点击「创建API密钥」
   3. 复制生成的 `API Key`（形如：sk-xx12xx34xx56...）
   

⚠️ 密钥仅显示一次，请立即保存至安全位置

二、环境变量配置

方法1：命令行临时设置（推荐开发测试）

# Linux/macOS
export DASHSCOPE_API_KEY="sk-xx12xx34xx56..."

# Windows
set DASHSCOPE_API_KEY="sk-xx12xx34xx56..."

方法2：永久配置（生产环境）

• Linux/macOS
  编辑 ~/.bashrc 或 ~/.zshrc：

  echo 'export DASHSCOPE_API_KEY="sk-xx12xx34xx56..."' >> ~/.bashrc
  source ~/.bashrc
  

• Windows

  1. Win+R → 输入 sysdm.cpl → 高级 → 环境变量
  2. 新建系统变量：

     变量名：DASHSCOPE_API_KEY
     变量值：sk-xx12xx34xx56...
     

三、Python 代码验证

安装 DashScope SDK：

pip install dashscope

验证脚本：

import os
import dashscope

# 读取环境变量
api_key = os.getenv("DASHSCOPE_API_KEY")
dashscope.api_key = api_key  # 注入密钥

# 测试模型调用
response = dashscope.Generation.call(
    model='qwen-turbo',
    prompt='你好'
)
print(response)

✅ 输出结果包含 status_code=200 即配置成功

四、安全注意事项

1. 密钥保护
   • 禁止提交到 Git 等版本控制系统
   • 使用 .gitignore 屏蔽环境配置文件
2. 访问控制
   在阿里云控制台设置「RAM 权限策略」，按需分配最小权限
3. 额度监控
   定期查看 DashScope 控制台的「用量统计」，避免超额费用

通过以上步骤，您已成功完成机器学习场景的 API 密钥配置。后续在代码中通过 os.getenv("DASHSCOPE_API_KEY") 即可安全调用服务。