通义千问 API 购买与接入教程（免费额度申请）
通过阿里云百炼或 DashScope 开通服务、获取密钥并调用最新 Qwen3.7-Max
BLUF 摘要（点开查看）
这篇教程用 6 个步骤说明 阿里云通义千问 API 如何注册、开通、获取 API Key 并完成首次接入；先确认国内直连、免费额度、计费单位，再把 Key 安全保存到环境变量或工具配置中。
教程概览
准备阿里云账号
使用通义千问 API 前，需要先完成阿里云账号注册与实名认证。
点击位置：浏览器访问 aliyun.com → 注册或登录 → 账号管理 → 账号认证
完成后看到：阿里云账号状态显示「已实名认证」
- 手机号是否能正常接收验证码
- 实名认证信息是否与身份证一致
- 访问阿里云官网：aliyun.com，使用手机号或邮箱注册账号
- 进入「账号管理」中的「账号认证」
- 按个人或企业身份完成实名认证
开通百炼或 DashScope 服务
推荐从阿里云百炼平台进入，也可以使用 DashScope 灵积平台。
点击位置：访问 bailian.console.aliyun.com 或 dashscope.console.aliyun.com → 搜索「通义千问」→ 开通
完成后看到：控制台显示已开通服务，可看到免费额度信息
- 确认实名认证已完成
- 如提示权限不足，检查账号类型是否支持开通
- 进入 https://bailian.console.aliyun.com 或 dashscope.console.aliyun.com
- 搜索或找到「通义千问」服务并点击开通
- 新用户免费额度、Token Plan 与可用模型以控制台当前展示为准
创建并保存 API Key
在 API-KEY 管理页面创建调用凭证，生成后立即保存。
点击位置：控制台 → 「API-KEY 管理」→ 「创建 API-KEY」
完成后看到：页面显示以 sk- 开头的密钥字符串，可复制
- 确认服务已开通
- 复制后立即保存到安全位置
- 关闭页面后通常无法再次查看完整密钥
- 进入「API-KEY 管理」页面
- 点击「创建 API-KEY」
- 复制以 sk- 开头的密钥，并保存到安全位置
配置环境变量并首次调用 Qwen3.7-Max
通义千问支持 OpenAI 兼容接口。2026 年 5 月百炼已列出 qwen3.7-max，适合先用真实任务验证最新旗舰模型。
点击位置：终端运行 pip install openai python-dotenv，创建 .env 写入 DASHSCOPE_API_KEY
完成后看到：Python 脚本成功打印模型回复，无报错
- 确认 DASHSCOPE_API_KEY 环境变量已设置
- 检查 base_url 是否为 DashScope 兼容模式地址
- 如报错 401，检查 API Key 是否正确
- 安装 openai 与 python-dotenv
- 设置 DASHSCOPE_API_KEY 环境变量
- base_url 使用 DashScope 兼容模式地址
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("DASHSCOPE_API_KEY"),
base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)
response = client.chat.completions.create(
model="qwen3.7-max",
messages=[{"role": "user", "content": "请用一句话介绍通义千问"}],
)
print(response.choices[0].message.content)按场景选择模型
通义千问覆盖 Agent 旗舰、通用、低成本和长上下文场景，按任务和预算选择即可。
点击位置：控制台 → 模型列表或文档页面
完成后看到：页面显示 qwen3.7-max、qwen3.6-plus、qwen3.6-flash 等模型名称、上下文和价格
- 确认模型名称拼写正确，例如 qwen3.7-max
- 如果账号暂未开放旗舰模型，先用 qwen3.6-plus 或 qwen-plus 跑通接口
- Qwen3.7-Max：最新旗舰 Agent 模型，1M 上下文、64k 最大输出，适合复杂推理、代码工程、办公自动化和长周期工具调用
- Qwen3.6-Plus：能力与成本均衡，1M 上下文，适合多数生产对话、知识库、摘要和代码任务
- Qwen3.6-Flash：低成本高频调用，适合简单对话、翻译、分类和批量处理
- qwen-plus / qwen-plus-latest：适合新手先跑通兼容接口，再按效果切换到 Qwen3.7-Max 或 Qwen3.6 系列
查看用量与控制成本
开通后在控制台查看免费额度、到期时间和后付费账单。
点击位置：控制台 → 「模型用量」页面
完成后看到：页面显示已使用的 Token 数量和剩余额度
- 确认查看的是正确的账号和区域
- 免费额度用尽后会按量计费
- 在「模型用量」页面查看剩余额度
- 免费额度用尽后按输入和输出 Token 计费
- qwen3.7-max 支持上下文缓存折扣，支持 Batch 时可按平台规则降低成本
配置推荐：使用 CC Switch 接入 AI 工具
创建 API Key 后，建议用 CC Switch 统一填写 API Key、Base URL 和模型名称，再接入 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具，避免手动修改配置文件出错。
使用提示
优先通过环境变量管理 DASHSCOPE_API_KEY
新手可先用 qwen3.6-plus 或 qwen-plus 跑通接口，再切换 qwen3.7-max 验证复杂任务
Agent、代码工程和办公自动化优先评估 qwen3.7-max；普通内容任务优先评估 qwen3.6-plus / qwen3.6-flash
注意事项
实名认证完成前，部分服务可能无法开通
不要把 API Key 写入公开代码、截图或客户端页面
适合谁
- • 国内用户，想快速接入 AI API
- • 需要手把手指导完成注册、充值和获取 Key 的新手
- • 想把 阿里云通义千问 接入 Claude Code、Codex 等工具的用户
常见问题
阿里云通义千问 有免费额度吗？
有，免费额度与试用模型以百炼控制台为准。建议先用免费额度测试真实任务，确认满足需求后再充值。
注册 阿里云通义千问 需要什么？
手机号或邮箱即可注册，支持支付宝/微信充值。部分 API 需要实名认证。
API Key 泄露了怎么办？
立即到控制台删除泄露的 Key 并重新生成。建议把 Key 存在环境变量或 .env 文件中，不要提交到 Git 仓库。