开通并配置阿里云百炼 Qwen API
最后核对：2026-09-21。 百炼的模型、免费额度、价格和地域范围会更新，请以本文链接的阿里云官方页面为准。
阿里云百炼提供 Qwen 等模型 API。第一次配置时最需要注意的是：API Key、Base URL 和模型必须属于同一个地域。
1. 注册并开通百炼
Section titled “1. 注册并开通百炼”2. 充值与创建 API Key
Section titled “2. 充值与创建 API Key”需要付费使用时，在阿里云 费用与成本 → 账户余额 中完成充值。官方充值方式和步骤见 在线充值说明。
- 打开 百炼 API Key 页面。
- 先确认页面顶部的地域。
- 选择 创建 API Key。
- 第一次使用可保持主账号、默认业务空间和页面建议权限。
- 创建后立即安全保存完整 Key。
创建 Key 时不需要选择模型，模型在 EasyAI 中单独填写。Key 删除后不能恢复，只能重新创建。
3. 在 EasyAI 中怎么填
Section titled “3. 在 EasyAI 中怎么填”打开对应 Agent 的 配置 API → 添加服务商：
| 字段 | 北京地域示例 |
|---|---|
| 服务商名称 | 阿里云百炼 Qwen |
| API 类型 | OpenAI Chat Completions |
| Base URL | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| API Key | 当前地域创建的百炼 Key |
| 默认模型 | qwen-plus，或官方模型列表中的准确 ID |
| 启用此服务商 | 开启 |
其他常用地域的 OpenAI 兼容地址：
| 地域 | Base URL |
|---|---|
| 新加坡 | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| 美国弗吉尼亚 | https://dashscope-us.aliyuncs.com/compatible-mode/v1 |
| 中国香港 | https://cn-hongkong.dashscope.aliyuncs.com/compatible-mode/v1 |
地域和地址可能扩展。配置前查看 百炼 Base URL 官方说明，不要凭地域名称猜地址。
保存后选择 配置生效，再执行 重新检测。看到“可访问”后启动新会话。
第一次使用可从 qwen-plus 这类稳定通用模型开始。需要其他能力时，在 百炼模型列表 中确认当前地域可用的准确模型 ID，并在 模型价格页 核对计费。
同一个模型不一定在所有地域开放。不要把北京地域创建的 Key 与新加坡 Base URL 混用。
400 Arrearage：账号欠费或余额不足，先检查费用中心。
401 InvalidApiKey：Key 错误，或 Key、地域、Base URL 不一致。
403 AccessDenied：当前业务空间、Key 或套餐没有模型权限。
404 ModelNotFound：模型 ID 错误、已经下线、当前地域没有该模型，或尚未开通百炼。
429 Throttling：达到当前模型的调用限制。降低并发和请求频率后重试。
详细说明见 百炼错误码 和 首次调用 Qwen API。