qwen3 中文文档 下载 App

阿里云百炼控制台接入 Qwen3 — 从注册到 API Key 获取全流程

什么是阿里云百炼

阿里云百炼（Model Studio）是阿里云的大模型服务平台。它提供：

百炼上可用的 Qwen3 模型规格：

模型对应开源规格思考模式多模态上下文
qwen3-max235B-A22B 旗舰默认开启否256K
qwen3-plus~32B Dense可选否128K
qwen3-flash~8B Dense可选否128K
qwen3-vl-plusVL 系列可选是（图+视频）256K
qwen3-vl-flashVL 轻量可选是（仅图）128K

步骤一：注册阿里云账号

如果还没有阿里云账号：

  1. 访问阿里云官方网站
  2. 点击免费注册，完成手机号验证和实名认证
  3. 企业用户可以选择企业认证（部分高级功能需要）

步骤二：开通百炼服务

  1. 登录阿里云控制台
  2. 搜索「百炼」或「Model Studio」，进入百炼控制台
  3. 首次进入需要同意服务协议
  4. 不需要单独付费开通——模型调用按量计费

步骤三：创建 API Key

API Key 是调用百炼 API 的凭证，需要妥善保管。

在百炼控制台创建

  1. 百炼控制台 → 右上角头像 → API-KEY 管理
  2. 点击「创建 API Key」
  3. 给 Key 起一个有意义的名字（如 qwen3-api-2025）
  4. 创建后立即复制保存——Key 只显示一次，忘了就只能新建

API Key 是敏感信息，不要提交到代码仓库，不要公开分享。建议用环境变量管理。

API Key 格式

百炼的 API Key 是一个字符串，类似于：

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

测试 API Key 是否有效

用 cURL 快速验证：

curl https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3-flash",
    "input": {
      "messages": [{"role": "user", "content": "你好"}]
    }
  }'

如果返回模型回复，说明 Key 有效。如果返回 401 或 403，检查 Key 是否正确复制。

百炼的两种接入方式

百炼提供两种 API 接口：

方式一：DashScope API（百炼原生）

方式二：OpenAI 兼容接口

环境变量管理 API Key

推荐把 API Key 放在环境变量里，不要硬编码在代码中。

Linux / macOS

export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxx"

Windows PowerShell

$env:DASHSCOPE_API_KEY = "sk-xxxxxxxxxxxxx"

Windows CMD

set DASHSCOPE_API_KEY=sk-xxxxxxxxxxxxx

之后在代码中通过 os.getenv("DASHSCOPE_API_KEY") 读取。

模型的思考模式控制

百炼云端 API 对思考模式的支持比开源模型更灵活：

云端模型默认行为可控制
qwen3-max自动判断（复杂问题自动思考）可以显式开启/关闭
qwen3-plus非思考可以显式开启/关闭
qwen3-flash非思考可以显式开启/关闭

显式控制方式：

# DashScope SDK
response = Generation.call(
    model="qwen3-plus",
    messages=messages,
    enable_thinking=True  # 显式开启思考
)

# OpenAI 兼容接口
response = client.chat.completions.create(
    model="qwen3-plus",
    messages=messages,
    extra_body={"enable_thinking": True}
)

计费说明

百炼按 token 计费，不同模型价格不同（以官方最新价格表为准）：

模型输入价格输出价格思考 token
qwen3-max较高较高计费（和输出同价）
qwen3-plus中等中等计费
qwen3-flash较低较低计费

关键提示：

用量查询

在百炼控制台可以查看：

也可以在阿里云费用中心查看总账单。

安全建议

  1. 不要在前端代码中硬编码 API Key——会被用户看到并滥用
  2. 生产环境建议用后端代理——前端调用你的后端，后端再调百炼
  3. 设置用量告警——在阿里云费用中心设置阈值告警，防止意外超支
  4. 使用最小权限——如果只需要文本生成，不要开启多模态权限
  5. 定期轮换 Key——如果怀疑泄露，立即停用旧 Key 并创建新的

接下来

拿到 API Key 后，查看：

相关阅读