阿里云百炼API Key获取全流程：免费额度申领与新手调用配置指南

一、前言

阿里云百炼是一站式大模型服务平台，提供通义千问、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步骤

1. 在百炼控制台左侧菜单栏找到「API-Key/密钥管理」（新版UI直接显示API-Key，老版叫密钥管理）
2. 进入API-Key页签，点击「创建API Key」按钮
3. 在弹窗中配置以下信息：
   • 归属业务空间：建议选择默认业务空间
   • 权限：建议选择「全部」（授予调用所有模型的权限）
   • 自定义权限：可配置IP白名单，增强安全性
4. 点击「确定」完成创建
5. 点击API Key旁的复制图标，保存密钥（仅显示一次，务必妥善保管）

4.4 权限配置说明

百炼提供两种权限配置方式：

• 全部权限：适合个人开发、测试场景，操作简单
• 自定义权限：适合企业生产环境，可配置IP访问白名单
  • 必须填写IP白名单，不能为空
  • 默认设置为0.0.0.0/0（允许所有IP访问）
  • 生产环境建议仅添加业务服务器IP，提升安全性

五、API Key使用与调用方法

5.1 调用所需信息

调用百炼模型需要三个核心信息：

1. API Key：刚刚创建并复制的密钥
2. Base URL：对应地域的接口地址（如北京地域）
3. 模型名称：如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能力。