阿里云百炼怎么用：API Key 配置与 Python 调用示例
阿里云百炼是阿里云推出的大模型服务平台，提供通义千问等模型的 API 调用能力。
想开始使用，核心步骤是：开通百炼服务、创建 API Key、在代码中通过兼容接口发起请求。
下面按实际操作为你梳理一遍。
开通服务与获取 API Key
首先登录阿里云控制台，搜索“百炼”进入产品页，按提示开通服务。
开通后进入百炼控制台，在左侧菜单找到 API-KEY 管理，点击“创建我的 API-KEY”。
创建成功后，复制生成的 Key 并保存到安全位置。API Key 只显示一次，丢失后只能重新创建。
建议不要直接写在代码里，而是通过环境变量传入。
在 Linux 或 macOS 终端中，可以这样设置临时环境变量：
export DASHSCOPE_API_KEY="你的API Key"Windows PowerShell 使用：
$env:DASHSCOPE_API_KEY="你的API Key"安装 SDK 并发送第一个请求
百炼同时支持 DashScope SDK 和 OpenAI 兼容接口。
如果你熟悉 OpenAI，可以直接用 openai 库；
想用阿里官方封装则安装 dashscope。
安装命令：
pip install openai dashscope使用 OpenAI 兼容方式调用通义千问：
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("DASHSCOPE_API_KEY"),
base_url="https://dashscope.aliyuncs.com/compatible-mode/v1"
)
response = client.chat.completions.create(
model="qwen-plus",
messages=[{"role": "user", "content": "用一句话介绍阿里云百炼"}]
)
print(response.choices[0].message.content)运行后如果看到模型返回的文本，说明调用成功。
注意 base_url 必须写兼容模式地址，模型名称如 qwen-plus、qwen-turbo 需与百炼控制台展示的一致。
常见报错与排查
调用过程中容易遇到几类问题，可以按以下方向检查：
- 401 鉴权失败：检查 API Key 是否复制完整、环境变量是否生效。可以在 Python 中打印
os.getenv("DASHSCOPE_API_KEY")确认非空。 - 404 模型不存在：确认
model参数拼写正确，并且该模型已在百炼控制台开通。 - 连接超时：检查服务器网络能否访问
dashscope.aliyuncs.com，必要时配置代理或安全组出站规则。 - 额度不足：新开通用户通常有免费额度，超出后需在控制台充值或调整模型。
安全与成本提醒
API Key 等同于账户调用凭证，不要提交到 Git 仓库或公开分享。
生产环境建议使用子账号或 RAM 角色进行权限隔离，并设置用量告警。
模型计费按 Token 计算，调试阶段可先用 qwen-turbo 等低成本模型验证逻辑。
验证调用是否正常
除了运行示例代码，还可以在百炼控制台的“模型体验”页面直接测试对话，确认服务本身可用。
如果控制台能正常返回，但代码报错，重点检查 SDK 版本、base_url 和 Key 传递方式。
按照以上步骤操作，你应该能完成阿里云百炼的基础接入。
后续可以根据业务需要调整模型参数、启用流式输出或接入知识库功能。
