能快速验证千问AI API是否正常响应：用curl命令发起HTTP请求，替换密钥后执行，返回含"output":{"text":...}的JSON即成功；需注意区分国内/国际域名、Bearer格式、隐藏字符及网络连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想快速验证千问AI API是否能正常响应，又不想写代码、不装SDK，直接用系统自带的curl命令发起HTTP请求是最省事的办法。你只需要一条终端指令，就能看到模型返回的原始JSON数据，整个过程不到十秒。
确认API密钥和端点地址
打开阿里云百炼控制台，在「API密钥」页面复制你的DASHSCOPE_API_KEY；同时记下你实际要调用的API地址，国内版必须是 https://dashscope.aliyuncs.com，国际版则是 https://dashscope.alibabacloud.com——用错域名会导致“Incorrect API key provided”错误，哪怕密钥完全正确。
这一步不能跳过：国内用户如果复制了国际文档里的URL，后续所有curl命令都会认证失败。
构造最简测试请求
在终端中执行以下命令：
curl -X POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation \
-H "Authorization: Bearer sk-xxxxxx" \
-H "Content-Type: application/json" \
-d '{ "model": "qwen-turbo", "input": { "prompt": "你好" } }'
把 sk-xxxxxx 替换成你的真实密钥，注意 Bearer 和密钥之间必须有一个空格，前后不能有换行或不可见字符。
如果返回包含 "output": {"text": "你好！我是通义千问..."} 的JSON，说明基础链路已通。
带系统角色的多轮对话测试
方法一：使用chat/completions风格（推荐）
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
curl -X POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation \
-H "Authorization: Bearer sk-xxxxxx" \
-H "Content-Type: application/json" \
-d '{ "model": "qwen-plus", "input": { "messages": [ {"role": "system", "content": "你是一个严谨的学术助手"}, {"role": "user", "content": "请用三句话解释梯度下降"} ] } }'
方法二：兼容旧版v1/chat/completions路径（部分部署支持）
curl -X POST http://localhost:9000/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{ "model": "/Qwen2.5-7B-Instruct", "messages": [{"role": "user", "content": "你好"}] }'
注意：本地部署的vLLM服务用的是http+端口形式，且无需Bearer认证；而阿里云官方API必须走HTTPS+Bearer，二者不可混用。
调试常见报错的三步定位法
第一步：检查密钥格式是否含Bearer前缀及多余空格
第二步：用 echo $DASHSCOPE_API_KEY | xxd 查看HEX值，确认无0a（换行）、20（多余空格）等隐藏字符
第三步：运行 curl -I https://dashscope.aliyuncs.com 验证域名可达性，返回 HTTP/2 401 表示服务在线但认证未通过，curl: (6) Could not resolve host 则是DNS或网络问题
只要完成这三步，95%的"Incorrect API key provided"错误都能当场解决。
