需完成API Key获取、环境变量配置、接口选择与调用、SDK使用及结果验证五步：一、在百炼控制台创建并启用API Key；二、设为DASHSCOPE_API_KEY环境变量；三、用OpenAI SDK配base_url和model参数；四、或用DashScope SDK调用；五、检查响应状态与错误信息。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已开通阿里云百炼服务并希望在阿里云平台上调用千问大模型，但尚未完成API接入配置，则可能是由于API Key未获取、环境变量未设置或调用参数不匹配所致。以下是具体部署与调用步骤：
一、获取并管理API Key
API Key是调用千问模型的身份凭证，必须通过阿里云百炼控制台生成并妥善保管。该密钥具有访问权限，不可泄露或硬编码于代码中。
1、登录阿里云百炼控制台，确保账号已完成实名认证。
2、在左侧导航栏选择「API密钥管理」，点击「创建API Key」按钮。
3、系统生成一对Key ID与Secret，请立即复制Secret值并保存至安全位置，页面关闭后无法再次查看。
4、确认API Key状态为「启用」，且所属主账号具备百炼服务调用权限。
二、配置调用环境
推荐将API Key注入系统环境变量，避免在代码中明文暴露密钥，提升安全性与跨项目复用能力。
1、在终端中执行命令设置环境变量（Linux/macOS）：
export DASHSCOPE_API_KEY="sk-xxxxxx"
2、若使用Windows PowerShell，运行：
$env:DASHSCOPE_API_KEY="sk-xxxxxx"
3、验证是否生效：
echo $DASHSCOPE_API_KEY（Linux/macOS）或 Write-Output $env:DASHSCOPE_API_KEY（PowerShell）
4、每次新开终端窗口均需重新执行环境变量设置，或将其写入~/.bashrc、~/.zshrc或系统级环境变量中实现持久化。
三、选择并调用兼容接口
阿里云百炼提供OpenAI兼容接口，支持使用标准OpenAI SDK调用千问系列模型，仅需调整base_url与model参数即可迁移现有代码。
1、确定所在地域对应的base_url：
北京节点：https://dashscope.aliyuncs.com/compatible-mode/v1
弗吉尼亚节点：https://dashscope-us.aliyuncs.com/compatible-mode/v1
新加坡节点：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
2、在Python代码中初始化OpenAI客户端时，指定base_url与model名称：
client = OpenAI(api_key=os.getenv("DASHSCOPE_API_KEY"), base_url="https://dashscope.aliyuncs.com/compatible-mode/v1")
3、调用时传入支持的模型标识，例如：qwen-plus、qwen-turbo或qwen-max，完整模型列表见官方文档。
四、使用DashScope原生SDK调用
DashScope SDK是阿里云官方维护的专用SDK，提供更细粒度的参数控制与错误反馈，适合对稳定性与调试深度有要求的场景。
1、安装SDK：
pip install dashscope
2、在Python脚本中导入并配置：
import dashscope
dashscope.api_key = os.getenv("DASHSCOPE_API_KEY")
3、发起文本生成请求：
response = dashscope.Generation.call(model='qwen-turbo', prompt='你好')
4、注意检查response.status_code是否为200，非200响应需解析error.message字段定位具体失败原因。
五、验证调用结果与基础调试
成功调用后应返回结构化JSON响应，包含模型输出内容及Token消耗统计。若返回空内容或报错，需按链路逐层排查。
1、运行最小可复现脚本，仅含初始化与单次请求，排除业务逻辑干扰。
2、检查HTTP响应头中的x-dashscope-status字段，确认服务端处理状态。
3、若提示“Invalid API key”，确认环境变量名称为DASHSCOPE_API_KEY且值无前后空格。
4、若提示“Model not found”，确认所填model参数属于当前地域可用模型列表，大小写需完全一致。
