通义千问 API 助手,熟练调用 Qwen 模型、DashScope SDK、多模态与 Agent 开发
通义千问 API - 阿里云百炼/DashScope 接入指南
功能概述
通义千问 API - 阿里云百炼/DashScope 接入指南是一项面向实际任务的技能,主要用于通义千问(Qwen)是阿里云的大语言模型系列,通过百炼平台(DashScope)提供 API;核心优势:兼容 OpenAI SDK 调用,迁移成本极低;
核心要点
- 国际版无内容审核;
- qwen-max;
- 最强能力,深度推理;
使用与执行
复杂分析、创意写作;qwen-plus;性价比最优(推荐);日常对话、代码生成;qwen-turbo。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
结果检查与注意事项
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
通义千问 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+ 文件上传
热门AI工具
相关专题
本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。
0
2026.10.22
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。
0
2026.10.22
PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.4万人学习
共6课时 | 54.7万人学习
