零基础也能跑通阿里云百炼 API，整套流程顺序是先完成账号实名、开通百炼领取免费 Token，再创建并且妥善保存 API 密钥，接着在本地电脑安装 Python、dashscope SDK 配置环境，最后运行流式调用代码，实现文字逐字输出的效果，很多新手踩坑主要是地域选错、密钥直接写死在代码里、忘记开启额度耗尽即停，导致免费额度用不了或者不小心产生扣费，免费 Token 只在华北 2（北京）地域生效，密钥是分地域独立的，跨地域不能混用，流式调用适合网页对话、AI 助手这类实时展示场景，和一次性返回全部内容的普通调用不一样，能明显降低等待感。
一、领取阿里云百炼免费 Token
- 登录阿里云账号，先完成实名认证，不实名无法发放免费额度
- 进入百炼控制台，右上角地域切换到华北 2（北京），阅读协议开通服务，开通后系统自动发放免费 Token，不用手动申领，额度有效期 90 天，每个主流模型单独分配额度，额度互相独立
- 进入资源用量页面查看剩余 Token，一定要打开
- 刚开通额度可能延迟 1-2 小时生效，没显示额度可以等待一段时间再重试
【免费额度用完即停】开关，额度耗尽直接拦截请求，防止自动按量扣费
二、创建与配置百炼 API 密钥
| 操作项 | 操作说明 | 新手注意点 |
|---|---|---|
| 进入密钥页面 | 百炼控制台左侧找到 API 密钥管理 | 地域保持华北 2，地域错了密钥不匹配 |
| 新建密钥 | 点创建 API Key，归属业务空间选默认，权限选全部，备注写用途 | 密钥弹窗只展示一次，关闭之后看不到完整密钥 |
| 复制保存 | 立刻复制 sk 开头的密钥，存到记事本、密码管理器 | 不要直接发给别人、不要写在前端页面 |
| 密钥安全管理 | 不同项目分开新建密钥，泄露之后直接作废单条密钥 | 支持多密钥管理，互不影响 |
三、本地环境搭建步骤
- 安装 Python，推荐 3.8 及以上版本，安装时勾选添加到系统环境变量
- 打开终端或者命令提示符，执行安装命令：pip install dashscope
- 配置环境变量（推荐方式，安全）
- Windows：set DASHSCOPE_API_KEY="你的 sk 密钥"
- Mac/Linux：export DASHSCOPE_API_KEY="你的 sk 密钥"
- 临时调试可以在代码里赋值 dashscope.api_key，正式项目禁止硬编码密钥
- 环境校验：终端输入 python，导入 dashscope 不报错，代表环境搭建成功
四、流式调用完整代码实操
import dashscope
from dashscope import Generation
from http import HTTPStatus
def stream_chat(prompt):
responses = Generation.call(
model="qwen-turbo",
messages=[{"role":"user","content":prompt}],
stream=True,
incremental_output=True
)
for chunk in responses:
if chunk.status_code == HTTPStatus.OK:
print(chunk.output.choices[0].message.content,end="")
else:
print(f"\n调用异常：{chunk.message}")
if __name__ == "__main__":
stream_chat("简单介绍一下阿里云百炼")
运行之后文字会逐段输出，就是流式效果，修改 model 参数可以切换 qwen-plus、qwen-long 等其他模型。
五、新手高频报错排查清单
- 报错鉴权失败：地域不对、密钥复制不全、密钥过期作废
- 扣钱而不是消耗免费额度：地域不是华北 2，免费额度已经用完，没开启用完即停
- 流式没有逐字输出：stream、incremental_output 两个参数没有同时打开
- 导入报错：dashscope 没有安装或者版本过低，执行 pip install --upgrade dashscope 升级
【相关 FAQ】
问题 1：阿里云百炼 API 免费 Token，是不是所有地域都可以使用？
回答 1：阿里云百炼 API 免费 Token 仅限华北 2（北京）地域使用，其他地域不享受新人免费额度，密钥、额度都是地域隔离，跨地域无法通用。
问题 2：阿里云百炼 API 密钥配置的时候，能不能直接把密钥写在 Python 代码里面？
回答 2：阿里云百炼 API 密钥配置，临时本地调试可以写在代码里，但是正式上线项目不建议硬编码，优先使用系统环境变量读取密钥，避免密钥泄露带来风险。
问题 3：阿里云百炼 API 流式调用和普通调用差别在哪，什么时候用流式调用？
回答 3：阿里云百炼 API 流式调用是分段返回结果，文字逐字输出，适合 AI 对话助手、网页实时问答；普通调用等模型全部生成完成一次性返回内容，适合摘要、批量处理等不需要实时展示的场景。
【参考资料】
[2026-11-04]（首次调用千问 API - 大模型服务平台百炼）阿里云帮助中心
[2026-10-26]（2026 阿里云百炼 API 指南：免费 Token、API Key、流式调用实战）阿里云开发者社区
[2026-10-21]（阿里云百炼 API Key 开发指南：密钥申请、权限配置）阿里云开发者社区
[2026-09-29]（千问大模型零成本上手：网页端与 API 免费额度实操）阿里云开发者社区
[2026-07-06]（阿里云百炼新人免费额度介绍）阿里云开发者社区
【免责声明】
本文为阿里云百炼 API 入门实操科普，免费 Token 额度、模型定价、接口参数、地域规则以阿里云百炼控制台实时页面为准；API 密钥属于敏感凭证，请妥善保管，密钥泄露造成的扣费、滥用风险由使用者自行承担；本文代码仅用于学习调试，生产环境上线前需要增加鉴权、限流、异常捕获等安全逻辑，不构成商业开发方案。