一、前言
阿里云百炼是阿里云提供的一站式大模型服务平台，支持各类模型调用、智能体接入、应用开发与部署。想要通过代码、第三方工具（如OpenClaw、Hermes Agent、Claude Code）接入百炼模型，必须先获取正确可用的API-Key。本文提供完整、可直接操作的API-Key开通与获取流程，全程清晰易懂，新手也能快速完成。
二、阿里云百炼API-Key获取前置条件
在创建API-Key之前，必须先完成两个关键开通步骤：
- 开通阿里云百炼平台服务。
- 开通百炼大模型调用服务。
只有完成这两步，创建API-Key的按钮才会可用，否则会提示“未开通服务”。
三、第一步：登录阿里云百炼平台
访问阿里云百炼大模型服务平台，进入阿里云百炼官方页面。
注册阿里云账号，使用已完成实名认证的阿里云账号登录。
如果是首次使用，页面会显示“免费体验”入口，点击进入平台。
登录成功后，即可进入百炼控制台首页。
四、第二步：开通阿里云百炼平台协议
首次进入百炼平台时，系统会弹出服务协议确认窗口。
需仔细阅读协议内容，确认无误后点击同意。
完成后，平台正式开通，进入控制台主界面。
新用户开通后可领取免费额度，包含多个模型的免费Tokens，足够用于测试与简单开发使用。
五、第三步：进入API-Key管理页面
在百炼控制台右上角，找到设置图标。
点击后左侧菜单栏会显示：
- 业务空间管理
- API-Key
- 账号管理
- 全局设置
点击 API-Key 选项，进入密钥管理页面。
首次进入时，页面会显示：
暂无API Key，若需要调用基础模型或应用，请申请API Key。
此时创建API-Key按钮处于灰色不可用状态，因为还未开通模型服务。
六、第四步：开通大模型服务
将鼠标移动到创建API-Key按钮上，会提示：
还未开通模型服务，暂不能使用该功能。
点击提示中的去开通按钮。
系统会弹出开通窗口，说明如下：
继续使用阿里云百炼大模型服务，需要开通以下商品，并创建模型调用API-Key。使用大模型服务会按计费规则进行计费。
同时会显示：
【开通即领取】每个模型赠送100万Tokens免费推理额度。
勾选下方的我已阅读并同意协议，然后点击确认开通，并领取免费额度。
开通成功后，页面自动返回API-Key页面。
七、第五步：创建并复制API-Key
开通模型服务后，创建API-Key按钮会变为蓝色可点击状态。
点击按钮，弹出创建窗口：
- 归属业务空间：默认选择默认业务空间即可
- 描述：可选填，用于标记密钥用途
点击确定，系统立即生成API-Key。
生成后页面会显示完整密钥信息，包括：
- ID
- API Key（以sk-开头）
- 所归属业务空间
点击右侧复制API Key，即可保存到本地。
⚠️ 注意：密钥只在创建时显示一次，关闭后无法再次查看，只能查看部分掩码内容，务必及时保存。
八、API-Key使用说明
获取到的API-Key可用于：
- 接入OpenClaw智能体
- 部署Hermes Agent
- 配置Claude Code
- 接入Python/Java/Node.js等代码调用
- 对接各类AI工具与低代码平台
使用时只需将密钥填入对应工具的配置项中，并填写正确的接口地址即可。
九、常见问题与注意事项
创建API-Key提示无权限？
→ 先开通百炼平台 + 开通模型服务，再重试。为什么复制的API-Key无法调用？
→ 确认密钥完整复制，没有丢失字符；确认已开通模型服务。API-Key泄露了怎么办？
→ 立即回到百炼API-Key页面，删除旧密钥，重新创建即可。免费额度在哪里查看？
→ 在百炼控制台概览页或资源包页面可查看剩余免费Tokens。如何查看自己的API-Key？
→ 进入设置 → API-Key 即可查看，但无法查看完整密钥，只能重新创建。
十、总结
阿里云百炼API-Key的获取流程非常简单，只需五步：访问阿里云百炼大模型服务平台并登录 → 开通平台 → 开通模型服务 → 创建密钥 → 复制保存。整个过程无需复杂操作，新手几分钟内即可完成。获取API-Key后，就能自由接入各类AI开发工具，使用百炼平台提供的强大模型能力。
