零基础也能上手！阿里云百炼 API 保姆教程——免费拿 Token、配密钥、搭环境、跑通流式调用

从零到跑通流式调用，所有命令可直接复制运行，所有坑都替你踩过。

一、为什么选择阿里云百炼？

在大模型浪潮席卷一切的当下，谁掌握了主流模型的接口能力，谁就握住了通往 AI 未来的船票。阿里云百炼大模型服务平台页面聚合百余款主流模型——从通义千问 Qwen3.8-Max 旗舰多模态，到 DeepSeek-V4-Pro，从文本生成到 3D 视频创作（Wan3.0），一站式覆盖全链路需求。

更令人心动的是，新用户开通即可畅享超 7000 万免费 Tokens，90 天有效期，覆盖 70 余款主流模型，每款模型独立分配约 100 万 Token，真正实现零成本、零门槛、零负担的原型开发。

本教程将手把手带你从零走到能跑通流式调用，所有命令可直接复制运行，所有坑都替你踩过了。

二、第一步：账号注册与实名认证——解锁一切的钥匙

打开阿里云百炼大模型服务平台页面，点击「免费体验」或「立即开通」。个人开发者无需企业营业执照，手机号或邮箱快捷登录即可。

关键前置动作：实名认证。 未实名账号无法创建 API-Key、无法领取免费额度、更无法调用任何接口。进入账号中心，填写身份信息完成核验——这是你通往 AI 世界的唯一钥匙。

提醒：如果你是企业团队使用，需要区分主账号与 RAM 子账号。主账号拥有全部权限，可直接创建密钥；RAM 子账号须由管理员提前分配业务空间管理员权限，否则无法生成 API-Key。

三、第二步：免费 Token 领取——超 7000 万 Tokens 自动到账

登录阿里云百炼大模型服务平台页面控制台，完成实名认证后，系统会自动发放免费 Tokens 至你的账号，无需额外手动操作。

但部分账号不会自动下发，需要你手动领取：

1. 进入阿里云百炼大模型服务平台页面控制台首页；
2. 找到「新手资源」横幅，点击「领取」按钮；
3. 即可获取 90 天有效期的千万级免费 Token。

领取完成后，进入「资源包 → 免费额度」页面，一目了然地查看各模型剩余额度与到期时间。

核心规则务必牢记

• 不同模型的免费额度互相独立，Qwen-Max 耗尽不影响 Qwen-Turbo 继续免费调用；
• 普通 sk- 开头的 API-Key 消耗免费额度，sk-sp- 开头的 Token Plan / Coding Plan 专属密钥不消耗免费额度，二者不可混用；
• 免费额度耗尽后，若已实名认证会自动切换按量付费模式，务必在控制台开启「额度用尽即停止调用」开关以防意外扣费。

四、第三步：API-Key 创建与安全管理——你的数字身份凭证

API-Key 是调用大模型接口的鉴权凭证，所有 SDK 调用、curl 请求、第三方 Agent 工具（OpenClaw、Hermes、Claude Code）都需要传入该凭证。

4.1 创建流程

1. 登录阿里云百炼大模型服务平台页面控制台，右上角切换地域为「华北2（北京）」；
2. 左侧导航栏进入「密钥管理」页面；
3. 点击右上角「创建 API-Key」；
4. 填写配置：

• 归属账号：个人选「主账号」，企业选对应 RAM 用户；
• 业务空间：选「默认业务空间」（可调用所有已授权标准模型）；
• 权限：建议选「全部权限」；安全要求高可自定义 IP 白名单（最多 20 个）和可访问模型（最多 30 个）；

1. 完成二次安全校验，生成密钥。

4.2 铁律：密钥只显示一次！

关闭弹窗后密钥内容脱敏，无法再次查看完整内容。务必立刻复制保存到记事本或密码管理器。 密钥丢失只能作废旧密钥、重新创建。

建议：不同项目、不同开发环境分开使用独立密钥，一旦泄露只需作废该密钥，不会波及其他业务。主账号最多创建 20 个业务空间，每个空间最多 20 个 API-Key，足够绝大多数个人与中小团队使用。

五、第四步：本地开发环境搭建与环境变量配置

本地开发需 Python 3.8 及以上版本。打开终端校验：

python --version\
pip --version

安装官方 DashScope SDK：

pip install dashscope --upgrade

5.1 Mac / Linux 环境变量配置

临时生效（仅当前终端会话）：

export DASHSCOPE_API_KEY="sk-你的完整APIKey"\
echo $DASHSCOPE_API_KEY

永久生效（写入 ~/.zshrc）：

echo "export DASHSCOPE_API_KEY=sk-你的完整APIKey" >> ~/.zshrc\
source ~/.zshrc

5.2 Windows PowerShell 环境变量配置

临时会话：

$env:DASHSCOPE_API_KEY="sk-你的完整APIKey"\
$env:DASHSCOPE_API_KEY

永久保存：

[Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY","sk-你的完整APIKey","User")

注意：配置完成后必须关闭已打开的终端和 IDE 重新打开才生效；使用 sudo 执行脚本时需加 -E 参数传递环境变量。

六、第五步：实战代码调用——从 curl 测试到 Python 流式输出

6.1 curl 命令快速测试（无需 Python 环境）

直接在终端验证密钥和网络连通性：

curl https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation \\
-H "Authorization: Bearer sk-你的完整APIKey" \\
-H "Content-Type: application/json" \\
-d '{ \
"model": "qwen-turbo",\
"input": { \
"messages": [\
{"role": "user", "content": "简单介绍百炼API-Key使用注意事项"}\
]\
}\
}'

6.2 Python 普通非阻塞调用

import dashscope\
import os\
\
dashscope.api_key = os.environ["DASHSCOPE_API_KEY"]\
\
response = dashscope.Generation.call(\
model='qwen-turbo',\
messages=[\
{'role': 'system', 'content': 'You are a helpful assistant.'},\
{'role': 'user', 'content': '你好，请介绍一下你自己'}\
]\
)\
\
print(response.output.text)

6.3 Python 流式输出调用（推荐用于对话场景）

import dashscope\
from dashscope import Generation\
import os\
\
dashscope.api_key = os.environ["DASHSCOPE_API_KEY"]\
\
responses = Generation.call(\
model='qwen-turbo',\
messages=[\
{'role': 'system', 'content': 'You are a helpful assistant.'},\
{'role': 'user', 'content': '请用三句话介绍阿里云百炼平台'}\
],\
stream=True # 流式模式\
)\
\
for response in responses:\
if response.output.text:\
print(response.output.text, end='', flush=True)

6.4 OpenAI 兼容接口调用（适配第三方工具）

若你使用 OpenClaw、Hermes Agent、Claude Code 等兼容 OpenAI 协议的工具，只需填写三项信息：

七、高频报错排查指南

八、总结：从零到跑通，你只需要这张路线图

注册账号 → 实名认证 → 开通百炼服务 → 领取免费 Token → 创建 API-Key\
→ 配置环境变量 → curl/SDK 调用 → 流式对话开发 → Agent/知识库搭建

登录阿里云百炼大模型服务平台页面，一切从这里开始。超 7000 万免费 Tokens、90 天有效期、百余款主流模型——这是阿里云给每一位 AI 探索者的诚意入场券。不要犹豫，不要等待，现在就打开阿里云百炼大模型服务平台页面，开启你的 AI 原型开发之旅！

延伸阅读：访问阿里云百炼大模型服务平台页面了解 Token Plan 订阅方案（个人版包月 39 元起）、Coding Plan AI 编码套餐，以及 Wan3.0 原生 3D 视频生成模型等最新能力更新。