1. 引言
阿里云百炼（Bailian）是阿里云推出的一站式大模型服务平台，集成了模型体验、API 调用、应用开发等能力。对于刚接触大模型开发的开发者来说，第一步就是完成账号注册、体验模型并获取 API Key。本文将带你走通从注册到创建 API Key 的完整流程，并教你如何管理费用用量，避免产生不必要的开销。
2. 注册与登录阿里云百炼
打开阿里云百炼官网地址：https://bailian.console.aliyun.com/
进入页面后，如果你还没有阿里云账号，需要先完成注册；如果已有账号，直接登录即可。登录成功后，你将进入百炼平台的控制台首页。
3. 在体验中心使用模型
登录后，点击左侧导航栏中的「体验中心」入口。体验中心提供了多个大模型的在线试用功能，你可以直接在网页上输入问题，与模型进行对话，快速感受不同模型的能力差异，无需编写任何代码。
这一步非常适合在正式接入 API 之前，先直观地了解各个模型的效果，帮助你选择适合自己业务场景的模型。
4. 创建 API Key
API Key 是调用百炼平台模型接口的凭证，创建步骤如下：
1在控制台左下角找到并点击「API-KEY」入口。
2进入页面后，如果显示「我们暂无 API Key」，点击「创建 API-KEY」按钮。
3.系统会生成一个新的 API Key，请务必立即复制并妥善保存 。关闭弹窗后，页面会显示一条新生成的 API Key 记录。
注意：API Key 只在生成时完整展示一次，关闭后无法再次查看完整内容，因此一定要在生成后第一时间复制保存到安全的地方。
5. 费用用量查看与管理
点击刚生成记录中的「查看费用」入口，你可以看到免费额度、模型用量等栏位信息。
在免费额度列表中，可以看到平台提供的多个模型及其对应的免费额度。当你使用某个模型时，建议将模型后面的「用完即停」按钮开启。这样当免费额度用尽后，系统会自动停止调用，避免产生免费额度以外的额外费用。
6. 调用云端模型
点击网页「模型」模块，进入「模型广场」。以 Qwen3.8-Max 为例，点击进入模型详情页，往下拉找到「API 代码示例」，复制粘贴到你的代码中。
1.如果没有配置环境变量，请用阿里云百炼 API Key 替换代码中的 api_key="sk-xxx"。
2.模型也是可以更换的。免费额度界面中有许多模型可以使用，如 deepseek-v4-flash-0731，将代码中的 model 替换后保存执行即可。
7. 环境变量配置
将 API Key 明文显示在代码中，存在很大的安全隐患。我们可以通过环境变量来隐藏明文 API Key。
1.Windows 配置
按 Win + S 搜索「高级系统设置」，点击「环境变量」，在「用户变量」中添加新的变量，添加好后点击「确定」。
配置好后，重启 VS Code（如果不生效，可以重启电脑试试）。
2.Mac 配置
打开电脑自带的终端，输入命令 open .zshrc 并回车。
不要修改其他内容，在中间空白处输入：
bash
export OPENAI_API_KEY="你的API key"保存后，重启 VS Code（如果不生效，可以重启电脑试试）。