跳到正文
阿里雲開發者社區 AI·· 13 天前AI 評分54

阿里雲百煉 API 入門教學:領取免費 Token、設定 API-Key 並完成串流調用

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

AI 導讀

這篇阿里雲百煉 API 教學示範如何開通服務、領取免費 Token、建立 API-Key,並設定本地環境以完成串流調用。文中列出新用戶可獲超 7000 萬免費 Token、有效期為 90 天,並指出額度按模型獨立計算,部分帳戶需手動領取。教學亦提供 curl、Python 調用範例,以及 OpenAI 相容工具的設定方式。

正文

2026-11-09 7

版权

版权声明:

本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写 侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

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

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


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

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

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

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


screenshot

screenshot

screenshot

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

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

关键前置动作:实名认证。 未实名账号无法创建 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 专属密钥不消耗免费额度,二者不可混用;
  • 免费额度耗尽后,若已实名认证会自动切换按量付费模式,务必在控制台开启「额度用尽即停止调用」开关以防意外扣费。

screenshot

screenshot

screenshot

四、第三步: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 参数传递环境变量。


screenshot

screenshot

screenshot

六、第五步:实战代码调用——从 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 协议的工具,只需填写三项信息:

参数 值
API-Key 刚从控制台复制的 sk- 密钥
Base-URL(国内) https://dashscope.aliyuncs.com/compatible-mode/v1
模型名称 qwen-plus / qwen3-max / deepseek-r1 等

七、高频报错排查指南

报错现象 可能原因 解决方案
401 鉴权失败 密钥填写错误或过期 核对密钥完整性,确认已开通模型服务
创建密钥按钮灰色 未开通大模型服务 返回阿里云百炼大模型服务平台页面点击「去开通」
地域不匹配报错 密钥签发地域与服务器运行地域不一致 确保均为同一地域(推荐北京)
模型响应超时 网络不稳或请求过大 调大超时参数,优化上下文配置
免费额度耗尽 90 天到期或单模型配额用完 控制台查看剩余额度,更换其他模型继续免费调用

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

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

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

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

來源:阿里雲開發者社區 AI · developer.aliyun.com