Qwen API 访问 为已经使用 OpenAI 风格客户端的团队提供两条实用路径。你可以通过阿里云 Model Studio 的 DashScope OpenAI 兼容接口直接调用 Qwen，也可以保留一个 Flatkey 路由基础 URL，并让 Qwen 与产品已路由的其他模型并用。
阿里云直连路径具有地域限制。Flatkey 路径使用 https://router.flatkey.ai/v1、Flatkey 密钥，以及在测试日志、计费单位、功能支持和回滚之前，从当前 Flatkey 目录中选择的 Qwen 模型 ID。
本指南将说明如何通过一个 OpenAI 兼容的基础 URL 使用 Qwen API 访问。内容包括阿里云官方文档已确认的事项、Flatkey 如何改变运行模式，以及在将生产流量切换之前需要验证的内容。
简明答案：通过一个路由器 Base URL 访问 Qwen API
如果你的应用已经使用 OpenAI 的 Python 或 JavaScript SDK，Qwen API 访问可以从配置变更开始，而不是重写提供方 SDK。
| 决策 | 在 Model Studio 中直接使用 Qwen | 通过 Flatkey 使用 Qwen |
|---|---|---|
| API key | 来自阿里云 Model Studio 的 DashScope API key | Flatkey API key |
| Base URL | 按区域区分的 DashScope OpenAI 兼容 URL | https://router.flatkey.ai/v1 |
| 主要目标 | 使用 OpenAI 兼容语法直接调用 Qwen | 在一个 key 之下，将 Qwen 与其他提供方一起路由 |
| 模型选择 | 来自阿里云文档和账号区域的 Qwen 模型 | 来自 Flatkey 定价或控制台的 Qwen 模型 |
| 验证 | 响应、功能支持、阿里云计费 | 响应、Flatkey 使用日志、计费单位、配额、回滚 |
当你只需要对 Qwen 进行阿里云账号级控制时，使用直接的 Model Studio 端点。当 Qwen 需要与 GPT、Claude、Gemini、DeepSeek、Seedance、图像模型以及其他模型家族一起，纳入同一套访问、路由、配额、使用日志和计费流程时，使用 Flatkey。
阿里云 Qwen 文档确认了什么
阿里云文档说明，Model Studio 中的 Qwen 模型支持 OpenAI 兼容接口。官方迁移说明很直接：调整 API key、BASE_URL 和模型名称。这与大多数 OpenAI 兼容 SDK 用户所期待的三步迁移模式一致。
官方文档列出了用于 SDK 调用的按地域划分的 base URL：
| Region | OpenAI-Compatible Base URL |
|---|---|
| Singapore | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| US (Virginia) | https://dashscope-us.aliyuncs.com/compatible-mode/v1 |
| China (Beijing) | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| Hong Kong (China) | https://cn-hongkong.dashscope.aliyuncs.com/compatible-mode/v1 |
OpenAI Chat 参考文档还说明了完整的聊天端点格式，例如用于美国调用的 POST https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions。同一文档还包含非流式聊天、流式输出、最终流片段中的 usage、工具调用、JSON 输出、用于具备视觉能力模型的图像输入，以及与搜索相关的选项示例。
这并不意味着每个 Qwen 模型都支持每一项功能。这意味着应按功能逐一测试 Qwen API 访问：先测试基础聊天，再测试流式、工具、JSON、视觉、搜索，或你的应用实际使用的任何端点。
Flatkey 如何改变 Qwen 的设置
Flatkey 改变了围绕 Qwen API 访问 的运维接入方式。与其在每个应用中直接选择一个 DashScope 区域基础 URL，不如将你的 OpenAI 兼容客户端指向一个路由器基础 URL：
https://router.flatkey.ai/v1当 Qwen 不是你技术栈中唯一的模型时，这条路由就很重要。Flatkey 的公开产品文案将平台定位为围绕一个 API 密钥、清晰定价、使用可见性，以及一个用于密钥、用量和路由的统一控制面板。本文对 Qwen 支持的验证，来自 Flatkey 价格目录的实时快照，而不是一个长期有效的首页声明。
本文检查的发布当天 Flatkey 价格快照返回了 638 条总模型记录和 63 条带 Qwen 名称的记录。在这些 Qwen 记录中，28 条在快照中被标记为可用，而且这些 Qwen 记录将 openai 公开为受支持的端点类型。请将其视为来自 2026 年 6 月 16 日的时点证据，而不是永久可用性保证：在生产流量之前，请在 定价 页面或控制台中确认当前的 Qwen 模型 ID。
Base URL 迁移模式
将Qwen API 访问保留在配置中，而不是在代码库中把提供商 URL 硬编码到各处。
FLATKEY_API_KEY="sk-fk-your-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_QWEN_MODEL="replace-with-flatkey-qwen-model-id"
# 可选的直接 Model Studio 值，用于对比或回滚。
DASHSCOPE_API_KEY="sk-your-dashscope-key"
DASHSCOPE_BASE_URL="https://dashscope-us.aliyuncs.com/compatible-mode/v1"关键区别在于路由的归属。直接的 Qwen 测试使用 DashScope 密钥和区域性 DashScope 基础 URL。Flatkey 测试使用 Flatkey 密钥和 Flatkey 路由器基础 URL。不要在这两条路径之间混用密钥、基础 URL 和模型 ID。
通过 Flatkey 使用 Qwen 的 Python 模板
仅限模板：在生产环境中使用之前，请先用有效的 Flatkey 密钥和已确认的 Flatkey Qwen 模型 ID 运行此代码。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FLATKEY_API_KEY"],
base_url=os.environ.get("OPENAI_BASE_URL", "https://router.flatkey.ai/v1"),
)
response = client.chat.completions.create(
model=os.environ["FLATKEY_QWEN_MODEL"],
messages=[
{
"role": "user",
"content": "请用一句话确认 Qwen 路由已配置。",
}
],
)
print(response.choices[0].message.content)
print(response.usage)这段代码的结构有意保持为普通的 OpenAI SDK 用法。生产工作在于选择正确的模型 ID、测试你的功能集，并确认请求会以预期的模型、状态、token 用量和成本出现在 Flatkey 使用日志中。
通过 Flatkey 使用 Qwen 的 JavaScript 模板
仅限模板：请使用有效的 Flatkey 密钥以及当前 Flatkey 目录中已确认的模型 ID 运行此示例。
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: process.env.OPENAI_BASE_URL || "https://router.flatkey.ai/v1",
});
const response = await client.chat.completions.create({
model: process.env.FLATKEY_QWEN_MODEL,
messages: [
{
role: "user",
content: "Reply with one sentence confirming the Qwen route is configured.",
},
],
});
console.log(response.choices[0].message.content);
console.log(response.usage);对于已经在使用兼容 OpenAI 的 JavaScript 客户端的团队来说，这使 Qwen API 访问足够精简，只需一次配置变更即可审查。该路由在投入真实流量前仍需要进行冒烟测试。
直接使用 Qwen 与 Flatkey：需要测试什么
当前搜索结果中的文章稀缺并不是又一份 Qwen 模型列表。官方文档已经提供了这一点。缺少的是一份实用的路由检查清单，用于判断何时直接使用 Qwen 就足够，以及何时一个基础 URL 是更清晰的运营路径。
| 工作流需求 | 直接 Qwen 检查 | Flatkey 路由检查 |
|---|---|---|
| 基础聊天 | 使用正确的区域 DashScope 基础 URL 和模型。 | 使用 https://router.flatkey.ai/v1 和一个 Flatkey Qwen 模型 ID。 |
| 流式传输 | 在 DashScope 中测试 stream: true 和最终 usage 处理。 |
通过 Flatkey 测试流分片、超时行为以及最终 usage 记录。 |
| 工具/函数调用 | 确认所选 Qwen 模型支持你发送的工具 schema。 | 确认同一 schema 能通过所选的 Flatkey Qwen 路由。 |
| JSON 输出 | 测试你精确的 response_format 模式。 |
通过路由验证解析器兼容性和错误行为。 |
| 视觉输入 | 选择一个 Qwen 视觉模型并测试图像负载格式。 | 确认 Flatkey 模型接受相同的图像输入形状。 |
| 成本审查 | 查看阿里云 Model Studio 的计费和定价文档。 | 查看 Flatkey 定价和实际使用日志。 |
| 多提供商路由 | 对于非 Qwen 模型，需要单独的提供商设置。 | 将 Qwen 与其他提供商一起放在一个密钥和仪表板后面。 |
烟雾测试运行手册
一个 Qwen API 访问 的烟雾测试应同时证明 API 行为和路由器可见性。
- 从当前 Flatkey 定价或仪表板中选择一个 Qwen 模型 ID。
- 创建或选择一个低风险的 Flatkey 密钥用于测试。
- 将
OPENAI_BASE_URL设置为https://router.flatkey.ai/v1。 - 运行一个简单的非流式聊天提示。
- 确认返回的响应结构与你的应用解析器兼容。
- 查看 Flatkey 使用日志中的模型、状态、token 用量和成本。
- 运行一次错误模型测试并记录错误结构。
- 仅在你的应用会使用时，才测试流式、工具、JSON、搜索或视觉功能。
- 在发送真实流量之前先设置一个较小的配额。
- 在路由稳定之前，保留直接 DashScope 或之前提供方的设置作为回滚配置。
目标不仅仅是让一个 Qwen 响应出现。目标是知道请求去了哪里、花了多少钱、失败时是什么样子，以及你能多快恢复到之前的路由。
常见错误
- 将 DashScope API 密钥与 Flatkey 基础 URL 一起使用，或者将 Flatkey 密钥与 DashScope 基础 URL 一起使用。
- 从阿里云文档复制 Qwen 模型名称时，没有确认 Flatkey 目录中的字符串。
- 假设所有 OpenAI 兼容参数在直连路径和路由路径中的行为都相同。
- 只测试非流式聊天，而生产环境使用的是流式、工具、JSON、搜索或视觉功能。
- 在成功响应后跳过 Flatkey 使用日志和计费检查。
- 发布包含看起来真实的密钥或未经测试的生产模型 ID 的代码片段。
这些都是小细节，但它们正是大多数Qwen API 访问迁移失败的原因。路由器让访问更容易；但它并不能免去对精确请求格式进行测试的需要。
这与现有 Flatkey 迁移指南的关系
如果这是你第一次进行路由迁移，请先阅读更全面的 OpenAI 兼容 API 迁移指南。它涵盖了适用于任何提供商的基础 URL 模式、环境变量、冒烟测试、回滚以及仪表板检查。
然后使用这份 Qwen 专用指南了解提供商细节：DashScope 区域端点、Qwen 模型选择、流式传输和功能测试，以及 Flatkey 目录检查。对于类似的提供商路由，可对比 Gemini API OpenAI 兼容路由指南。
常见问题
如何获得 Qwen API 访问权限？
你可以直接通过阿里云 Model Studio 使用 DashScope API 密钥获取 Qwen API 访问权限，也可以使用 Flatkey 密钥通过 Flatkey 路由 Qwen，接口地址为 https://router.flatkey.ai/v1。直接方式使用按地区划分的 DashScope 基础 URL；Flatkey 方式则将 Qwen 保持在一个多模型网关中。
Qwen API 是否兼容 OpenAI？
阿里云在 Model Studio 中为 Qwen 模型提供了兼容 OpenAI 的接口文档。迁移时需要更改 API 密钥、基础 URL 和模型名称。对于流式传输、工具、JSON 输出、视觉、搜索以及任何高级参数，仍需进行功能级测试。
Qwen 兼容 OpenAI 的直连基础 URL 是什么？
这取决于地区。阿里云列出了多个地区的基础 URL，包括美国（弗吉尼亚）的 https://dashscope-us.aliyuncs.com/compatible-mode/v1、新加坡的 https://dashscope-intl.aliyuncs.com/compatible-mode/v1，以及中国（北京）的 https://dashscope.aliyuncs.com/compatible-mode/v1。
通过 Flatkey 使用 Qwen 时应使用哪个基础 URL？
通过 Flatkey 使用 Qwen 时，请使用 https://router.flatkey.ai/v1。然后从 Flatkey 定价或控制台中选择当前可用的 Qwen 模型 ID，并在生产流量前测试请求。
我可以在 Flatkey 中使用阿里云文档里的相同 Qwen 模型 ID 吗？
不能自动通用。模型字符串、别名、可用性和端点支持可能会因目录和路由而异。请在测试当天从 Flatkey 选择模型 ID，并将其保存在配置中。
OpenAI 兼容是否意味着功能完全一致？
不一定。OpenAI 兼容通常表示支持的端点可以使用常见的请求和响应格式。但这并不保证每个模型、参数、端点、地区、流式模式、工具调用或多模态负载的行为都完全一致。
我应该如何通过路由器为 Qwen 做预算？
直连 Model Studio 场景请参考阿里云定价文档；通过 Flatkey 路由的用量请参考 Flatkey 定价。然后在 Flatkey 日志中核实实际请求成本，因为模型、缓存、端点和模态单位可能不同。
在路由生产流量之前查看定价
当你的应用已经使用 OpenAI 风格的 SDK 调用时，通过兼容 OpenAI 的路由器访问 Qwen API 是一条实用的迁移路径。尽量把改动保持得很小：更新 base URL，使用 Flatkey key，选择当前的 Qwen 模型，运行 smoke tests，并在上线前验证 usage 和 pricing。
查看定价，在发送生产流量之前确认当前可用的 Flatkey Qwen model 选项和 cost units。
