Qwen API 指南：中国境外 Python & Node.js 接入
阿里巴巴的 Qwen3.8 在 Artificial Analysis 智能指数上比肩 GPT-5.6 Sol，并支持高达 100 万 token 的上下文。本指南将介绍如何通过 ChinaModelAPI 兼容 OpenAI 的端点在全球范围内调用 Qwen API，并提供可直接运行的 Python 和 Node.js 代码示例。
from openai import OpenAI
client = OpenAI(api_key="YOUR_KEY", base_url="https://api.chinamodelapi.com/v1")
print(client.chat.completions.create(
model="qwen-plus",
messages=[{"role":"user","content":"ping"}],
).choices[0].message.content)什么是 Qwen API？
Qwen API 是阿里云为其 Qwen（通义千问）大语言模型系列提供的开发者接口。该 API 采用 OpenAI chat completions 格式，是已在使用 GPT 模型的开发者的无缝平替方案。
Qwen API 核心要点：
- • 兼容 OpenAI — 采用与 GPT 相同的请求/响应格式
- • Qwen-Max 上下文窗口 — 最高可达 1,000,000 tokens
- • 语言支持 — 多语言（100+），在中英双语上表现优异
- • AA 智能指数 — 顶级开源权重梯队，性能媲美 GPT-5.6 Sol
- • 支持能力 — 聊天、函数调用（function calling）、流式传输（streaming）、视觉（Qwen-VL）
Qwen 模型：该选择哪一款？
| 模型 ID | 适用场景 | 上下文 | 速度 | 成本 |
|---|---|---|---|---|
| qwen-3 | 通用任务，最新性能 | 128K | 快速 | $$ |
| qwen-max | 长文档、复杂推理 | 1M | 中等 | $$$ |
| qwen-plus | 均衡：速度 + 质量 | 128K | 快速 | $$ |
| qwen-2.5 | 稳定生产环境工作负载 | 128K | 快速 | $ |
| qwen-2.5-coder | 代码生成 & 补全 | 128K | 快速 | $ |
中国境外接入 Qwen API 教程：4 个步骤
-
1
Create a ChinaModelAPI account
在 chinamodelapi.com 注册 — 无需信用卡。
-
2
Purchase tokens with USDT
Starter 套餐（$9.9）足以满足测试需求。Tokens 永不过期。
-
3
Copy your API key
控制台获取的密钥通用于所有 Qwen 模型。
-
4
Change base_url in your SDK
仅需一行代码 — 详见下方示例。
Python 接入：Qwen API
安装 OpenAI Python SDK：pip install openai
from openai import OpenAI
client = OpenAI(
base_url="https://api.chinamodelapi.com/v1",
api_key="your-chinamodelapi-key"
)
response = client.chat.completions.create(
model="qwen-3", # or qwen-max, qwen-plus, qwen-2.5
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Explain transformer architecture in 3 sentences."}
],
max_tokens=1024
)
print(response.choices[0].message.content)流式响应示例：
stream = client.chat.completions.create(
model="qwen-max",
messages=[{"role": "user", "content": "Write a Python function for binary search."}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Node.js 接入：Qwen API
安装: npm install openai
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.chinamodelapi.com/v1",
apiKey: "your-chinamodelapi-key"
});
const response = await client.chat.completions.create({
model: "qwen-3", // or "qwen-max", "qwen-plus"
messages: [
{ role: "user", content: "Translate this to Chinese: Hello, world!" }
]
});
console.log(response.choices[0].message.content);常见问题解答
我可以免费使用 Qwen API 吗？
ChinaModelAPI 不提供免费层，但 $9.9 的 Starter 套餐提供了大量 tokens，非常适合测试和小型项目。Tokens 永不过期，因此完全没有用完的时限压力。
Qwen API 支持函数调用吗？
支持。Qwen3.8 和 Qwen-Max 支持兼容 OpenAI 的函数调用（工具调用）。请求格式与 OpenAI 完全一致 — 只需在 tools 参数中定义工具，模型便会返回结构化的函数调用。
Qwen-Max 的上下文窗口有多大？
Qwen-Max 支持最高 1,000,000 tokens 的上下文 — 相当于约 75 万个词或一整本书的体量。这是目前可用的最大上下文窗口之一，非常适合用于分析长文档、代码库或研究论文。
Qwen API 有速率限制吗？
速率限制取决于您的套餐等级。Starter 套餐提供适合开发的基础限额；Pro 及以上等级提供更高的吞吐量；Enterprise 企业套餐包含定制速率限制和 SLA 服务保障。如需具体数值，请联系我们。
相关指南
准备好使用 Qwen API 了吗？5 分钟内即可获取接入。
获取早鸟接入