阿里云百炼 · 百万 tokens 免费 · 支付宝充值

通义千问（Qwen）配置教程

阿里巴巴推出的通义千问是国产大模型旗舰之一，开源版本（Qwen2.5、Qwen3）在国际榜单上表现亮眼。本教程教你通过阿里云百炼平台快速接入。

开始配置 模型对比 常见问题
← 总览教程 DeepSeek 教程 Kimi 教程 →

为什么选择通义千问？

  • 国内直连 — 阿里云全球节点，访问速度快且稳定
  • 免费额度大方 — 多数模型新用户百万 tokens 免费，部分模型限时免费
  • 模型矩阵全 — 文本、代码、视觉、长上下文（千问 1M）一应俱全
  • 支付宝充值 — 阿里云账号即可付款，企业可开发票
  • OpenAI 兼容 — 提供兼容模式 API，龙虾配置极简
  • 开源生态 — 模型权重在 HuggingFace / ModelScope 开源，可本地部署

分步教程

通过阿里云百炼平台，5 分钟完成接入

1

注册阿里云账号

通义千问 API 通过阿里云百炼平台提供，需要先有阿里云账号。如果你已经用过阿里云、淘宝、支付宝，可以直接复用。

  1. 访问 bailian.console.aliyun.com（百炼控制台）
  2. 点击右上角 "登录" / "注册"
  3. 支持手机号、淘宝/支付宝账号登录
  4. 首次进入需完成实名认证（个人/企业均可）
  5. 同意服务条款，进入百炼控制台
提示：已有阿里云账号可直接登录，无需重复注册。实名认证完成后才能调用 API。
注意：国内用户需要完成实名认证（身份证或营业执照），这是阿里云的统一要求。
2

开通百炼模型服务

登录后需要开通对应的模型服务（一次性操作，免费）。

  1. 进入百炼控制台首页
  2. 左侧菜单找到 "模型广场" 或 "Model Studio"
  3. 选择想用的模型（如 qwen-plus、qwen-turbo），点击 "立即开通"
  4. 勾选服务条款，确认开通（免费）
  5. 开通后即可获得免费额度（通常每个模型 100 万 ~ 500 万 tokens）
福利：百炼平台对绝大多数模型提供新用户免费额度，足够日常体验数月。多个模型分别有独立额度。
3

创建 API Key

在百炼控制台创建 API 密钥，用于龙虾连接通义千问。

  1. 百炼控制台右上角点击头像 → "API-KEY 管理"
  2. 或直接访问 API-KEY 管理页
  3. 点击 "创建我的 API-KEY"
  4. 选择业务空间（默认 "default" 即可），填入备注（如 "XiaoJuClaw"）
  5. 创建完成后立即点击"查看"复制密钥（以 sk- 开头）
# 通义千问 API Key 格式示例
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
安全提醒：API Key 一旦泄露请立即在控制台删除并重建，避免被恶意调用消耗额度。
4

在龙虾中配置通义千问

通义千问提供 OpenAI 兼容模式，龙虾选择 "OpenAI Compatible" 或 "自定义提供商" 即可接入。

  1. 打开龙虾（OpenClaw）客户端
  2. 进入 "设置" → "模型配置" 或 "AI Provider"
  3. 选择 "OpenAI Compatible" / "自定义提供商"
  4. 填写以下信息：
    • API Key：粘贴你的通义千问密钥
    • Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
    • 模型名称：qwen-plus / qwen-turbo / qwen-max 等
  5. 点击 "测试连接" 确认成功
  6. 保存设置
# 环境变量配置（OpenAI 兼容模式）
OPENAI_API_KEY=sk-你的通义千问密钥
OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
MODEL_NAME=qwen-plus

# 如果龙虾支持独立配置 Qwen / DashScope
DASHSCOPE_API_KEY=sk-你的通义千问密钥
关键点：注意 Base URL 末尾必须带 /compatible-mode/v1，这是通义千问的 OpenAI 兼容入口；如果使用 DashScope 原生模式，URL 不同。
5

验证并开始使用

发送一条消息测试是否成功：

  1. 在龙虾对话框输入 "你好，请用中文介绍一下你自己"
  2. 如果收到回复（会自称通义千问），配置成功
  3. 报错时检查：Key 是否正确、Base URL 末尾 /compatible-mode/v1 是否完整、模型是否已开通
完成！开始享受通义千问的中文能力和长上下文体验吧。

通义千问主流模型

价格以官方公布为准，免费额度可在百炼控制台查看；以下为常用商业模型。

模型名称 适用场景 上下文 价格（每百万 tokens） 推荐
qwen-turbo 日常问答、写作、客服 128K 输入 ¥0.3 / 输出 ¥0.6 性价比首选
qwen-plus 通用任务、推理、代码 128K 输入 ¥0.8 / 输出 ¥2 日常推荐
qwen-max 最强通义旗舰，复杂任务 32K 输入 ¥2.4 / 输出 ¥9.6 高质量场景
qwen-long 超长文档分析（千万字级） 10M 输入 ¥0.5 / 输出 ¥2 长文档专用
qwen3-coder-plus 代码生成、补全、Agent 编程 1M 按阶梯计费 编程推荐
qwen-vl-plus 图文理解、OCR、视觉问答 32K 输入 ¥1.5 / 输出 ¥4.5 多模态
选型建议：新手从 qwen-plus 开始（免费额度大，能力均衡）；预算有限选 qwen-turbo；写代码用 qwen3-coder-plus；需要看图选 qwen-vl-plus。

费用估算（以 qwen-plus 为例）

使用场景 单次消耗（约） ¥10 能用多少次
简单问答（几句话） ¥0.001 ~ ¥0.005 2000 ~ 10000 次
代码生成（中等复杂度） ¥0.01 ~ ¥0.04 250 ~ 1000 次
长文档分析 ¥0.05 ~ ¥0.20 50 ~ 200 次
免费额度提醒：新用户开通模型后通常有 100 ~ 500 万 tokens 免费额度，按场景换算约等于免费 ¥10 ~ ¥50 的使用量，先用免费的足够体验很久。

常见问题

通义千问 / 阿里云百炼相关的常见疑问

百炼平台、DashScope、通义千问是什么关系？
  • 通义千问（Qwen）：阿里巴巴的大模型品牌名（包含 qwen-turbo / plus / max 等）
  • DashScope：阿里云的 AI 模型服务底层平台（API 域名 dashscope.aliyuncs.com）
  • 百炼（Bailian）：DashScope 的控制台和应用平台，用于开通模型、管理 Key、调试应用
简单说：在百炼控制台开通服务和拿 Key，调用时打到 DashScope 的 API 地址，模型就是通义千问。
OpenAI 兼容模式 vs DashScope 原生模式怎么选？
  • OpenAI 兼容模式：URL 是 ...compatible-mode/v1，请求格式和 OpenAI 一样。龙虾推荐用这个，配置最简单。
  • DashScope 原生模式：URL 是 ...api/v1/services/aigc/text-generation/generation，是阿里自己的格式。功能稍多但配置复杂。
除非有特殊需求，否则一律用兼容模式。
免费额度怎么查，用完会自动扣费吗？
在百炼控制台 → "模型广场" 找到对应模型，点进去能看到剩余免费额度。免费额度用完后会自动从阿里云账户余额扣费，所以建议在阿里云账户中心设置消费提醒，避免意外扣费。
通义千问 vs DeepSeek 怎么选？
  • 通义千问：模型种类多（文本/视觉/长文档/代码全覆盖），免费额度大方，企业服务完善
  • DeepSeek：价格更低，代码和推理能力突出，平台简洁
如果你需要多模态、超长上下文或企业开发票，选通义千问；如果只用文本/代码且追求极致性价比，选 DeepSeek。两者都国内直连，可以同时配置随时切换。
报错 "Model not found" 或 "InvalidParameter" 怎么办？
常见原因：
  • 模型未开通 → 去百炼"模型广场"开通对应模型
  • 模型名拼错 → 注意 qwen-plus 而不是 qwen_plus 或 QwenPlus
  • 用了原生模式的 URL 配兼容模式的请求 → 检查 Base URL 末尾是否为 /compatible-mode/v1
  • 账号未实名 → 完成阿里云实名认证
能开发票吗？企业可以用吗？
可以。阿里云百炼支持企业实名，可开增值税发票（普票/专票），适合公司报销和正式商用。这是相比部分中转站的明显优势。

开始使用通义千问

百万 tokens 免费额度，国内直连，模型矩阵齐全

前往百炼平台 返回总览教程 查看 DeepSeek 教程