千问AI API怎么用curl测试?

风辰君_1039

风辰君_1039

2026-08-08

715人浏览

原创

能快速验证千问AI API是否正常响应:用curl命令发起HTTP请求,替换密钥后执行,返回含"output":{"text":...}的JSON即成功;需注意区分国内/国际域名、Bearer格式、隐藏字符及网络连通性。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

千问ai api怎么用curl测试?

想快速验证千问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风格(推荐)

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": "请用三句话解释梯度下降"} ] } }'

Analyze Video By Qwen Free
Analyze Video By Qwen Free

Qwen 视频智能分析基础客户端(免费版),基于 Qwen 3.5 Plus 多模态模型对本地视频进行内容分析,支持场景描述与基础内容理解,采用默认抽帧频率和提示词,适合快速概览视频,API Key 读取自 ~/.skill-platform/skill-platform.json 的 skills 配置。

下载

方法二:兼容旧版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"错误都能当场解决。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关专题

更多
curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

2023.06.14

3943

6

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

2023.10.30

955

4

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

40

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

40

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

20

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

140

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

100

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

100

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

100

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP使用CURL抓取页面
PHP使用CURL抓取页面

共4课时 | 3.1万人学习

前端最全HTTP基础原理及应用
前端最全HTTP基础原理及应用

共12课时 | 2.2万人学习