阿里云百炼 API 指南：模型、定价与 OpenAI 兼容接入

阿里云百炼是阿里巴巴的托管 AI 模型平台，通过 DashScope API 提供整个 Qwen 系列的推理服务。DashScope 同时支持原生协议和 OpenAI 兼容端点——你只需修改现有 OpenAI SDK 代码中的三个值（API Key、Base URL、模型名称），即可对接 Qwen 模型，无需重写任何业务逻辑。

我们写这篇阿里云百炼 API 指南，是因为 DashScope 的文档分散在中英文数十个页面中，而且"百炼""DashScope""Model Studio"之间的关系让大多数开发者在首次接触时感到困惑。这篇文章是我们最初将阿里云百炼加入路由配置时想要的唯一参考。

百炼和 DashScope 是什么

命名容易混淆，先理清层级关系：

• 阿里云百炼 / Alibaba Cloud Model Studio：管理控制台——你在这里管理工作空间、API Key、微调任务和计费。
• DashScope：API 服务层，所有模型推理请求都通过 DashScope 端点发出。
• 百炼 是中国大陆品牌名，国际用户看到的是 "Model Studio"。

实际上"百炼"和 "Model Studio" 指同一个产品。DashScope 是你与它交互的编程接口。

三分钟快速上手

第一步：注册阿里云账号。 访问 aliyun.com（中国大陆）或 alibabacloud.com（国际），在控制台中开通百炼服务。

第二步：获取 API Key。 进入 API Key 管理页面，创建新的 API Key。DashScope 支持将 Key 限定到特定工作空间，适合多团队场景下的权限隔离。

第三步：发起第一个请求。 安装 OpenAI Python SDK：

pip install --upgrade openai

然后将 SDK 指向 DashScope：

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",  # 北京
)

response = client.chat.completions.create(
    model="qwen-plus",
    messages=[
        {"role": "system", "content": "你是一个有用的助手。"},
        {"role": "user", "content": "什么是阿里云百炼？"},
    ],
)
print(response.choices[0].message.content)

就这么简单。除非你需要异步视频生成等原生专属功能，否则不需要安装 DashScope 专用 SDK。

各区域 OpenAI 兼容端点

DashScope 提供多个区域端点，选择离你部署最近的：

重要提示： API Key 是区域绑定的。在北京控制台生成的 Key 无法用于新加坡端点，反之亦然。切换区域后遇到 InvalidApiKey 错误，请在目标区域的控制台重新生成 Key。

OpenAI 兼容端点支持 Chat Completions、流式输出、Tool Calling（函数调用）、Embeddings 和 Responses API。异步操作（如视频生成和 TTS）使用 DashScope 原生 API。

通过百炼可用的 Qwen 及第三方模型

百炼主要提供 Qwen 模型家族。截至 2026 年 6 月，通过 OpenAI 兼容端点可用的主要模型层级包括：

商业模型（阿里巴巴托管）：

• Qwen-Max 系列 — qwen3.7-max、qwen3-max、qwen-max：旗舰推理与生成模型，支持思考和非思考模式，最新 qwen3.7-max 上下文窗口达 1M tokens。
• Qwen-Plus 系列 — qwen3.7-plus、qwen3.5-plus、qwen-plus：性价比较高的通用模型，上下文最长 1M tokens。
• Qwen-Flash 系列 — qwen3.5-flash、qwen-flash：为低延迟场景优化。
• Qwen-Turbo — qwen-turbo：最便宜的商业选项，适合高吞吐低复杂度任务。
• Qwen-Coder 系列 — qwen3-coder-plus、qwen3-coder-flash：代码专用模型。
• QwQ 系列 — qwq-plus：推理专用模型。

开源模型（百炼托管）：

• qwen3.5-397b-a17b、qwen3.5-120b-a10b、qwen3.5-27b、qwen3-235b-a22b、qwen3-32b、qwen3-14b、qwen3-8b 以及更小的变体。
• Qwen 2.5 系列，包括 1M 上下文版本：qwen2.5-14b-instruct-1m、qwen2.5-7b-instruct-1m。

模型可用性因区域而异。中国大陆端点提供最全的选择；新加坡端点覆盖大多数国际模型；美国端点子集较小。务必查看官方支持模型列表确认目标区域的可用模型。

定价、配额和速率限制

百炼按 Token 计费，采用阶梯定价（单价取决于单次请求的输入 Token 总量）。以下价格为人民币/百万 Token。

Qwen-Max（中国大陆，2026 年 6 月）：

Qwen-Plus（中国大陆）：

国际（新加坡）定价约为大陆价格的 3–4 倍。

免费额度： 新开通百炼的账号可获得部分模型各 100 万 Token 的免费额度（输入/输出各算），开通后 90 天内有效，无需绑定信用卡。

Batch API： 支持 Batch 推理的模型按实时价格的 50% 计费。

速率限制 按账户+模型维度计算。以全球部署的 qwen3-max 为例，文档标注的限制起步为 600 RPM。限制同时在每分钟和每秒（RPM/60）级别生效。触发 429 后通常 1 分钟内恢复。官方建议的应对策略：回退到备用模型快照（如用 qwen-plus-2025-07-14 作为 qwen-plus-2025-07-28 的备用）。

最新定价和速率限制详情请参阅官方定价页面和速率限制文档。

百炼 vs SiliconFlow vs 火山引擎：路由视角对比

如果你在中国 LLM 供应商之间做选择，百炼是与 SiliconFlow 和火山引擎 Ark 并列的三大选项之一。从路由角度看它们的差异：

如果团队主要使用 Qwen 模型，百炼是最权威的源——你能最先拿到最新的模型快照、享受官方速率限制和直接支持。如果需要跨多个中国模型家族路由，SiliconFlow 的广度可能更实用。更详细的对比请参阅我们的 SiliconFlow vs DashScope 对比。

常见集成错误

区域切换后 InvalidApiKey。 DashScope 的 API Key 是区域绑定的。北京控制台生成的 Key 无法在新加坡端点认证。请在正确区域的控制台重新生成 Key。

Model not found 或 Model does not exist。 模型可用性因区域和部署范围不同。查看对应区域的支持模型列表。部分模型（如 qwen-math-plus）仅在中国大陆部署中可用。

429 Rate limit exceeded。 百炼在账户层级同时执行 RPM 和 TPM 限制，外加每秒突发限制。解决方案：用指数退避平滑请求频率，回退到备用模型快照，或对非实时任务使用 Batch 推理。

Allocated quota exceeded。 通常意味着触发了 TPM（每分钟 Token）上限。缩短 prompt、减少 max_tokens，或将长文档拆分为更小的请求。

混淆 Coding Plan 端点与标准百炼端点。 Coding Plan 使用专用端点（https://coding.dashscope.aliyuncs.com/v1）和独立的 API Key。不要将 Coding Plan Key 与标准百炼 sk-* Key 混用——它们不可互换。

新加坡域名迁移。 阿里巴巴正在将新加坡区域的 https://dashscope-intl.aliyuncs.com 迁移到基于工作空间的 URL（https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com）。如果看到弃用警告，请更新 base_url。

多供应商路由中的百炼

当我们将 OpenAI 兼容请求路由到配置的供应商时，百炼天然适合作为后端。OpenAI 兼容端点意味着不需要协议转换——同样的请求格式可以在 OpenAI、SiliconFlow 和 DashScope 之间无缝切换。

一个实用的路由模式：将百炼作为 Qwen 模型的主要供应商（它是官方源，拥有最新的模型快照），配置 SiliconFlow 或其他供应商作为降级备选。如果百炼返回 429，路由层可透明地重试备选供应商。更多关于跨供应商设计降级链的内容，请参阅我们的 LLM API 降级路由指南。

# 示例：OpenAI SDK 使用百炼作为主供应商
from openai import OpenAI

# 主：百炼
bailian_client = OpenAI(
    api_key="sk-bailian-xxx",
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

# 备：SiliconFlow
siliconflow_client = OpenAI(
    api_key="sk-siliconflow-xxx",
    base_url="https://api.siliconflow.cn/v1",
)

try:
    response = bailian_client.chat.completions.create(
        model="qwen3-max",
        messages=[{"role": "user", "content": "解释量子计算"}],
    )
except Exception:
    # 降级到 SiliconFlow
    response = siliconflow_client.chat.completions.create(
        model="Qwen/Qwen3-235B-A22B",
        messages=[{"role": "user", "content": "解释量子计算"}],
    )

常见问题

百炼和 DashScope 是同一个东西吗？ 百炼是产品/控制台品牌；DashScope 是底层 API 服务。实际上它们指同一个平台。API 调用通过 DashScope 端点发出；你在百炼控制台管理一切。

可以直接用 OpenAI SDK 对接百炼吗？ 可以。将 base_url 设为对应的 DashScope 端点，使用百炼 API Key 即可。Chat Completions、流式输出、Tool Calling 和 Embeddings 均不需要额外 SDK。

百炼有哪些免费模型？ 新账号可在 qwen3.7-max、qwen3.7-plus 等模型上获得各 100 万 Token 的免费额度，开通后 90 天内有效。部分开源模型有独立的免费配额。详见定价页面。

百炼定价和 OpenAI 相比如何？ 百炼上的 Qwen 模型比同级 OpenAI 模型便宜很多。例如 qwen3-max 在中国大陆端点的起步价为 ¥2.5/百万输入 Token（约 $0.35 USD），大约是 GPT-4o 的 1/10。国际端点价格更高，但仍有竞争力。

可以从中国境外使用百炼吗？ 可以。使用新加坡（dashscope-intl.aliyuncs.com）、美国弗吉尼亚（dashscope-us.aliyuncs.com）或香港端点。你需要阿里云国际账号和对应区域的 API Key。

百炼支持函数调用 / Tool Use 吗？ 支持。OpenAI 兼容端点支持与 OpenAI API 相同格式的 Tool Calling。较新的模型版本还支持结构化输出和 Responses API。

---

来源：Alibaba Cloud Model Studio — OpenAI 兼容、百炼模型定价、速率限制、DashScope API 参考。检索时间：2026 年 6 月。