全称Client URL客户端 URL 请求工具跨系统内置命令行 HTTP 工具无额外安装用于网络请求、接口调试、数据收发。一、核心作用等价命令行版 requests可访问网页、调用 API、下载文件、测试服务连通性调试 Ollama/OpenAI 接口常用。二、基础语法bash运行curl [参数] 请求地址三、高频常用参数参数作用-X指定请求方法 GET/POST/PUT/DELETE-H自定义请求头鉴权、声明数据格式-d携带请求体数据JSON / 表单-o将响应保存为文件-O按原文件名下载保存-i打印响应头 响应内容-s静默模式隐藏冗余日志-L自动跟随网页重定向-m设置请求超时时间四、基础请求示例1. GET 请求bash运行# 直接访问页面 curl https://www.baidu.com2. POST 请求调用 Ollama 模型bash运行curl -X POST http://localhost:11434/v1/chat/completions \ -H Content-Type: application/json \ -d { model:qwen2:7b, messages:[{role:user,content:简单介绍curl命令}] }3. 带鉴权请求头bash运行curl -H Authorization: Bearer sk-xxxx https://api.openai.com/v1/models4. 文件下载bash运行# 自定义文件名保存 curl -o test.jpg https://xxx.img.jpg # 沿用原文件名保存 curl -O https://xxx.img.jpg5. 查看完整响应信息bash运行curl -i https://www.baidu.com五、数据格式用法JSON 数据搭配-H声明类型-d传 json 字符串表单数据bash运行curl -d nametestage18 网址六、和同类工具对应关系curl命令行发起 HTTP 请求requestsPython 代码发起 HTTP 请求OpenAI SDK基于网络请求封装的 AI 专用调用工具底层均遵循 HTTP 协议通信逻辑一致七、常见状态码含义200请求成功401权限密钥错误404地址不存在429请求频次超限500服务端异常八、实用小技巧换行\拆分长命令可读性更高静默调试加-s屏蔽进度输出接口不通优先用 curl 测试快速定位网络、服务、参数问题
