一、前言
阿里云百炼是一站式大模型服务平台，提供通义千问、DeepSeek、Kimi、GLM等数十款主流模型的API调用能力，是开发者接入国产大模型的核心入口。想要通过代码、终端工具（如Claude Code）、智能体（如OpenClaw、Hermes）调用百炼模型，必须先获取有效的API Key作为鉴权凭证。
对于新手而言，百炼提供了超7000万免费Tokens的新人福利，无需付费即可体验全量模型。本文将从账号准备、服务开通、API Key创建、免费额度领取到实际调用，提供完整、可直接操作的全流程指南，覆盖所有新手常见问题与避坑要点。详情👉访问阿里云百炼大模型服务平台页面 了解
二、前置准备：账号与实名认证
2.1 账号注册与登录
使用阿里云百炼的第一步是拥有阿里云账号。你可以通过以下方式注册：
- 访问阿里云官网，点击右上角「登录/注册」
- 支持支付宝、淘宝、手机号等多种方式一键注册
- 已有阿里云账号可直接登录，无需重复注册
2.2 实名认证（必须完成）
实名认证是使用百炼API的硬性要求，不完成实名认证无法创建API Key，也无法领取免费额度。
- 登录后点击右上角头像，选择「实名认证」
- 选择个人认证，通过支付宝刷脸即可完成，全程仅需10秒
- 无需绑卡、无需充值，纯免费体验
三、开通百炼服务与免费额度自动领取
3.1 进入百炼控制台
- 在阿里云首页搜索框输入「百炼」，点击「大模型服务平台百炼」进入官方控制台
- 或直接访问百炼控制台入口（无需手动输入链接，通过搜索进入即可）
- 详情👉访问阿里云百炼大模型服务平台页面 了解
3.2 开通百炼服务
首次进入百炼控制台会弹出「开通百炼大模型平台」提示：
- 勾选服务协议，点击「立即开通」或「免费体验」
- 开通无需付费，免费额度自动到账，无需额外领取
- 开通成功后自动跳转到百炼主控制台
3.3 免费额度详情
新用户开通后自动获得新人专属免费Tokens：
- 总额度超7000万，覆盖70+款主流模型
- 每款模型各赠100万免费Tokens（输入、输出分别计算）
- 有效期90天，从开通当日起计算
- 仅支持抵扣模型实时推理费用，不支持调优、部署等场景
- 主账号与RAM子账号共享免费额度
- 仅中国内地版模型享有免费额度，国际地域无免费福利
四、API Key创建全流程（核心步骤）
4.1 权限要求
创建API Key需满足以下权限条件：
- 使用阿里云主账号
- 或使用被授予「管理员」或「API-Key页面权限」的RAM子账号
- 普通子账号无创建权限，需主账号授权
4.2 地域选择
百炼支持多个地域，国内业务优先选择华北2（北京）：
- 华北2（北京）：
https://dashscope.aliyuncs.com/compatible-mode/v1 - 新加坡：
https://dashscope-intl.aliyuncs.com/compatible-mode/v1 - 美国（弗吉尼亚）：
https://dashscope-us.aliyuncs.com/compatible-mode/v1 - 德国（法兰克福）：国际业务专用
4.3 创建API Key步骤
- 在百炼控制台左侧菜单栏找到「API-Key/密钥管理」（新版UI直接显示API-Key，老版叫密钥管理）
- 进入API-Key页签，点击「创建API Key」按钮
- 在弹窗中配置以下信息：
- 归属业务空间：建议选择默认业务空间
- 权限：建议选择「全部」（授予调用所有模型的权限）
- 自定义权限：可配置IP白名单，增强安全性
- 点击「确定」完成创建
- 点击API Key旁的复制图标，保存密钥（仅显示一次，务必妥善保管）
4.4 权限配置说明
百炼提供两种权限配置方式：
- 全部权限：适合个人开发、测试场景，操作简单
- 自定义权限：适合企业生产环境，可配置IP访问白名单
- 必须填写IP白名单，不能为空
- 默认设置为0.0.0.0/0（允许所有IP访问）
- 生产环境建议仅添加业务服务器IP，提升安全性
五、API Key使用与调用方法
5.1 调用所需信息
调用百炼模型需要三个核心信息：
- API Key：刚刚创建并复制的密钥
- Base URL：对应地域的接口地址（如北京地域）
- 模型名称：如qwen3.7-plus、deepseek-chat等
5.2 环境变量配置（推荐）
通过环境变量配置API Key，安全且便于管理：
macOS/Linux终端
export DASHSCOPE_API_KEY="你的百炼API Key"
export DASHSCOPE_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export DASHSCOPE_MODEL="qwen3.7-plus"
Windows Git Bash
set DASHSCOPE_API_KEY=你的百炼API Key
set DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
set DASHSCOPE_MODEL=qwen3.7-plus
5.3 代码调用示例（Python）
import os
from openai import OpenAI
# 初始化客户端
client = OpenAI(
api_key=os.getenv("DASHSCOPE_API_KEY"),
base_url=os.getenv("DASHSCOPE_BASE_URL")
)
# 调用模型
response = client.chat.completions.create(
model=os.getenv("DASHSCOPE_MODEL"),
messages=[{
"role": "user", "content": "你好，请介绍一下阿里云百炼"}]
)
# 输出结果
print(response.choices[0].message.content)
5.4 终端工具调用（Claude Code）
# 配置环境变量
export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export ANTHROPIC_AUTH_TOKEN="你的百炼API Key"
export ANTHROPIC_MODEL="qwen3.7-plus"
# 启动Claude Code
claude
六、常见问题与避坑指南
6.1 无法创建API Key
- 问题：创建按钮灰色不可点击
- 原因：未完成实名认证或未开通百炼服务
- 解决：先完成实名认证，再开通百炼服务
6.2 API Key调用失败
- 问题：返回鉴权失败、无权限
- 原因：API Key错误、地域不匹配、权限不足
- 解决：核对API Key、确认Base URL、检查权限配置
6.3 免费额度未到账
- 问题：开通后未看到免费Tokens
- 原因：未完成实名认证、地域选择错误
- 解决：完成实名认证，选择华北2（北京）地域
6.4 额度消耗过快
- 问题：免费额度消耗超出预期
- 原因：长文本、多轮对话、上下文缓存消耗
- 解决：控制单次请求长度，定期清理上下文
6.5 安全注意事项
- API Key相当于账号密码，严禁泄露
- 不要将API Key直接写入代码提交到仓库
- 生产环境使用IP白名单限制访问
- 定期轮换API Key，提升安全性
七、额度管理与查询
7.1 查看免费额度
- 在百炼控制台左侧菜单栏找到「额度管理」
- 查看各模型免费剩余额度、已使用量、有效期
- 支持按模型、按时间维度筛选查询
7.2 额度耗尽处理
- 免费额度耗尽后，系统会自动提示
- 可选择购买付费额度包继续使用
- 或等待下一轮新人福利（仅限新用户）
八、总结
阿里云百炼API Key是接入国产大模型的核心凭证，获取流程简单、免费额度丰厚，非常适合新手入门。从账号注册、实名认证、服务开通到API Key创建，全程零门槛、零付费，新用户可获得超7000万免费Tokens，足以支撑学习和小规模项目开发。详情👉访问阿里云百炼大模型服务平台页面 了解
获取API Key后，可通过环境变量、代码、终端工具等多种方式调用百炼模型，兼容OpenAI接口标准，无缝对接Claude Code、OpenClaw、Hermes等AI工具。在使用过程中，注意API Key的安全保管，合理控制额度消耗，遇到问题可参考常见问题解决方案快速排查。
通过本文的全流程指南，新手可以快速掌握阿里云百炼API Key的获取与使用方法，开启国产大模型开发之旅，无需担心复杂配置和高额成本，真正实现零门槛体验AI能力。
