以下是解决阿里云 DashScope API Key 获取和环境变量配置问题的完整指南，包含常见避坑要点：

一、API Key 获取步骤

1. 登录控制台
   访问 阿里云DashScope控制台 → 用阿里云账号登录

2. 创建API Key

   • 左侧菜单选择 "API密钥管理"
   • 点击 "创建API密钥" → 系统自动生成API Key
   • 关键提示：密钥仅显示一次，请立即复制保存

3. 开通服务

   • 在 "模型服务" 菜单开通所需服务（如通义千问）
   • 新用户通常有免费额度

二、环境变量配置

▶ Windows 系统

# 方法1：临时生效（当前终端）
setx DASHSCOPE_API_KEY "您的实际密钥"

# 方法2：永久配置
1. Win+R 输入 `sysdm.cpl`
2. 高级 → 环境变量 → 新建系统变量：
   变量名：DASHSCOPE_API_KEY
   变量值：您的密钥

避坑点：

• 不要包含引号 "
• 修改后重启所有终端和IDE

▶ Linux/macOS 系统

# 永久生效
echo 'export DASHSCOPE_API_KEY="您的实际密钥"' >> ~/.bashrc  # 或 ~/.zshrc
source ~/.bashrc

# 临时生效
export DASHSCOPE_API_KEY="您的实际密钥"

避坑点：

• 确认使用正确的配置文件（bash/zsh）
• 执行 source 使配置立即生效

三、验证配置

import os
key = os.getenv("DASHSCOPE_API_KEY")
print("密钥状态:", "✅ 成功" if key else "❌ 未检测到")

常见错误排查：

1. 环境变量未生效

   • 重启终端/IDE
   • 在Python中运行 os.environ 查看所有变量

2. 密钥格式错误

   • 确保无多余空格：sk-xxxxxx 格式
   • 不要包含换行符

3. 服务未开通
   在DashScope控制台确认已开通目标API服务

四、SDK调用示例

from http import HTTPStatus
import dashscope

# 通过环境变量自动读取密钥
dashscope.api_key = os.getenv("DASHSCOPE_API_KEY")

response = dashscope.Generation.call(
    model='qwen-turbo',
    prompt='你好'
)
if response.status_code == HTTPStatus.OK:
    print(response.output.text)
else:
    print(f'错误码: {response.code}, 信息: {response.message}')

终极避坑提示：

1. 密钥泄露风险：切勿提交到Git仓库，建议使用 .env 文件 + .gitignore
2. 区域限制：确保账号和服务在相同地域（如华东1）
3. 权限问题：主账号需为API Key授权RAM权限
4. 额度检查：免费额度用尽后需充值

若仍遇到问题，可在控制台提交工单，附上错误截图和SDK版本信息（如 dashscope==1.14.0）。