通义千问 API 购买与接入教程
通过阿里云百炼或 DashScope 开通服务、获取密钥并完成首次调用
✓ 免费额度大✓ 国内直连✓ OpenAI 兼容接口✓ 模型选择丰富
1
准备阿里云账号
使用通义千问 API 前，需要先完成阿里云账号注册与实名认证。
- 访问 aliyun.com，使用手机号或邮箱注册账号
- 进入「账号管理」中的「账号认证」
- 按个人或企业身份完成实名认证
2
开通百炼或 DashScope 服务
推荐从阿里云百炼平台进入，也可以使用 DashScope 灵积平台。
- 进入 bailian.console.aliyun.com 或 dashscope.console.aliyun.com
- 搜索或找到「通义千问」服务并点击开通
- 新用户免费额度以控制台当前展示为准
3
创建并保存 API Key
在 API-KEY 管理页面创建调用凭证，生成后立即保存。
- 进入「API-KEY 管理」页面
- 点击「创建 API-KEY」
- 复制以 sk- 开头的密钥，并保存到安全位置
⚠ API Key 通常只完整显示一次，不要写入前端代码或公开仓库。
4
配置环境变量并首次调用
通义千问支持 OpenAI 兼容接口，可用 OpenAI SDK 快速调用。
- 安装 openai 与 python-dotenv
- 设置 DASHSCOPE_API_KEY 环境变量
- base_url 使用 DashScope 兼容模式地址
python
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="qwen-plus",
messages=[{"role": "user", "content": "请用一句话介绍通义千问"}],
)
print(response.choices[0].message.content)5
按场景选择模型
通义千问覆盖轻量、通用、旗舰和长文本等场景，按任务选择即可。
- Qwen-Turbo：适合简单对话、实时翻译和低成本高频调用
- Qwen-Plus：适合多数通用对话、摘要、问答和中等复杂代码任务
- Qwen-Max：适合复杂推理、深度创作和企业级高质量任务
- Qwen-Long：适合长文档总结、论文分析、合同解析和代码仓库理解
⚠ 模型价格、免费额度和上下文长度会随平台更新，正式购买前以控制台为准。
6
查看用量与控制成本
开通后在控制台查看免费额度、到期时间和后付费账单。
- 在「模型用量」页面查看剩余额度
- 免费额度用尽后按输入和输出 Token 计费
- 批量推理或缓存能力可进一步降低成本
使用提示
优先通过环境变量管理 DASHSCOPE_API_KEY
日常开发建议从 qwen-plus 或 qwen-turbo 开始测试
长文档任务优先评估 Qwen-Long
注意事项
实名认证完成前，部分服务可能无法开通
不要把 API Key 写入公开代码、截图或客户端页面