通义千问怎么用：网页、App与API调用的实际步骤
通义千问有两种常见用法：普通用户在网页或手机App里直接对话；
开发者到阿里云百炼平台开通服务、创建API Key，再通过接口调用。
前者不需要任何环境配置，后者需要账号实名和密钥管理。
下面按实际使用顺序说明。
网页版和App：登录后直接对话
浏览器打开通义千问官网，用阿里云账号或手机号登录，进入对话页即可输入问题。
手机端在应用商店搜索“通义”下载官方App，登录同一账号后，历史会话一般可以同步。
新手最容易忽略的是提问方式。
把问题写成“背景+任务+格式”三段，结果会明显更可用。
例如：
- 背景：我在运营一个服务器运维博客，读者是零基础用户。
- 任务：写一段Nginx反向代理的配置说明。
- 格式：分步骤列出，每步给出一条配置和验证命令。
如果回答太长或偏题，直接补充限制条件，例如“控制在300字以内”“只保留命令，不要解释原理”。
多轮对话中，通义千问会参考上文，所以发现方向不对时，最好新开会话重新描述，而不是在错误答案上反复修补。
开发者接入：开通百炼并拿到API Key
需要在自己的程序里调用通义千问时，走阿里云百炼平台。
大致流程如下：
- 登录阿里云控制台，完成账号实名认证。
- 进入百炼产品页，按页面提示开通服务。
- 在API Key管理页面创建密钥，复制后保存到本地，不要写进前端代码或公开仓库。
- 在模型列表中确认要调用的模型名称，不同模型的能力和计费方式不同。
调用时通常使用兼容OpenAI格式的接口地址，把API Key放在请求头里。
下面是一个最小验证示例，实际模型名和地址以控制台文档为准：
curl https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-plus",
"messages": [{"role": "user", "content": "用一句话解释什么是反向代理"}]
}'把密钥放进环境变量再引用，比直接写在命令里安全。
返回结果中如果能看到choices字段和模型回复内容，说明密钥和网络都正常。
容易踩的坑
- 密钥泄露：API Key等同于账号调用凭证，不要提交到Git仓库，也不要在浏览器端直接请求。
- 模型名写错：接口返回模型不存在时，先回控制台核对模型名称，不要凭记忆填写。
- 额度或欠费：调用报权限或额度错误时，检查百炼服务是否开通、账户是否欠费。
- 长文本截断：输入超过模型上下文限制会被截断，长文档建议分段处理。
- 把AI输出直接上线：命令、配置和参数要人工核对后再执行，尤其是涉及删除、重启和权限变更的操作。
怎么确认自己用对了
网页版验证很简单：提一个需要分步骤回答的问题，看回复是否按你要求的格式组织。
API调用则看HTTP状态码和返回体：状态码200且choices[0].message.content有内容，说明调用成功；
返回401优先查密钥，返回404优先查模型名和接口地址。
日常使用时，建议固定一套提问模板，把常用背景和格式要求保存下来，每次替换任务内容即可。
这样既减少重复描述，也更容易比较不同回答的质量。
