通义千问 API - 阿里云百炼/DashScope 接入指南
简介
通义千问（Qwen）是阿里云的大语言模型系列，通过百炼平台（DashScope）提供 API。
核心优势：兼容 OpenAI SDK 调用，迁移成本极低；国际版无内容审核。
模型矩阵
| 模型 | 特点 | 适用场景 |
|---|
| qwen-max | 最强能力，深度推理 | 复杂分析、创意写作 |
| qwen-plus | 性价比最优（推荐） | 日常对话、代码生成 |
| qwen-turbo | 响应最快 | 简单任务、高并发 |
| qwen-long | 长文本（1000 万 token） | 超长文档分析 |
| qwq-plus | 推理增强（思维链） | 数学、逻辑推理 |
| qwen-vl-max | 视觉理解 | 图片/视频分析 |
| qwen-audio-turbo | 音频理解 | 语音转录、音频分析 |
API 端点
| 地域 | Base URL | 说明 |
|---|
| 新加坡（国际版） | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 | 推荐，无内容审核 |
| 中国（北京） | https://dashscope.aliyuncs.com/compatible-mode/v1 | 国内访问快 |
| 美国（弗吉尼亚） | https://dashscope-us.aliyuncs.com/compatible-mode/v1 | 美国节点 |
基础调用（兼容 OpenAI SDK）
pip install -U openai
from openai import OpenAI
client = OpenAI(
api_key="sk-your-dashscope-api-key",
base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
)
response = client.chat.completions.create(
model="qwen-plus",
messages=[
{"role": "system", "content": "你是一个专业的编程助手。"},
{"role": "user", "content": "用 Python 实现一个 LRU 缓存"}
]
)
print(response.choices[0].message.content)
多模态调用
# 图片理解
response = client.chat.completions.create(model="qwen-vl-max", messages=[{"role": "user",
"content": [{"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}},
{"type": "text", "text": "描述图片内容"}]}])
# 视频理解
response = client.chat.completions.create(model="qwen-vl-max", messages=[{"role": "user",
"content": [{"type": "video_url", "video_url": {"url": "https://example.com/video.mp4"}},
{"type": "text", "text": "总结视频内容"}]}])
函数调用
tools = [{"type": "function", "function": {"name": "get_weather", "description": "获取城市天气",
"parameters": {"type": "object", "properties": {"city": {"type": "string"}}, "required": ["city"]}}}]
response = client.chat.completions.create(
model="qwen-plus", messages=[{"role": "user", "content": "北京天气？"}], tools=tools)
绕过内容审核（国际版）
import json
response = client.chat.completions.create(model="qwen-plus",
messages=[{"role": "user", "content": "你的问题"}],
extra_headers={"X-DashScope-DataInspection": json.dumps({"input": "disable", "output": "disable"})})
仅在国际版端点生效，国内版无法禁用审核。
长文本处理（qwen-long，支持 1000 万 token）
file = client.files.create(file=open("long_doc.pdf", "rb"), purpose="file-extract")
response = client.chat.completions.create(model="qwen-long", messages=[
{"role": "system", "content": f"fileid://{file.id}"},
{"role": "user", "content": "总结文档核心观点"}])
定价（每百万 token）
| 模型 | 输入 | 输出 |
|---|
| qwen-plus | ¥0.8 | ¥2.0 |
| qwen-max | ¥2.0 | ¥6.0 |
| qwen-turbo | ¥0.3 | ¥0.6 |
最佳实践
- 日常推荐
qwen-plus，兼顾能力和成本
- 国际版 + 禁用审核 = 无内容限制
- 超长文档用
qwen-long + 文件上传
