用curl测试deepseek api是验证密钥、网络与接口可用性的最快方式,需先确保curl≥7.68且已安装,再获取合法api密钥,通过get /v1/models和post /v1/chat/completions接口依次测试鉴权与模型调用功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用curl测试DeepSeek API,是验证密钥有效性、网络连通性与基础接口可用性的最快方式,不需要写代码、不依赖任何开发环境,只要终端能运行curl命令就能立刻发起请求。
确认curl已安装并可用
在终端中执行 curl --version,看到类似 curl 8.10.1 (Windows) libcurl/8.10.1 的输出即表示已就绪。若提示“command not found”,需先安装curl:Windows用户可下载官方预编译包并添加到PATH,macOS用户用 brew install curl,Linux用户用 sudo apt install curl(Ubuntu/Debian)或 sudo yum install curl(CentOS/RHEL)。
这一步不可跳过——【没有curl或版本过旧(低于7.68)会导致HTTP/2支持失败、签名头解析异常】。
获取合法API密钥
登录DeepSeek开发者控制台,在「密钥管理」页生成新的AccessKey和SecretKey。注意:AccessKey用于请求头中的 X-DS-AccessKey,SecretKey必须离线保存,绝不可出现在命令行历史或脚本明文中。
临时测试时,可将AccessKey存为环境变量:export DEEPSEEK_API_KEY="sk-xxx"。但【生产环境严禁硬编码密钥,务必通过环境变量或密钥管理服务注入】。
测试基础连通性
执行以下命令:
curl -v https://api.deepseek.com
观察响应状态码。返回 HTTP/2 200 表示域名解析、TLS握手、服务端监听均正常;若卡住或返回 Failed to connect,说明本地网络或代理配置有问题;若返回 403 Forbidden 或 401 Unauthorized,说明域名或路径有误,不是鉴权问题(此请求未带认证头)。
调用模型列表接口(GET)
这是最轻量、无需签名的公开接口,适合首次验证密钥格式是否正确:
方法一:直接传入密钥字符串curl -X GET "https://api.deepseek.com/v1/models" -H "Authorization: Bearer sk-xxx"
方法二:使用环境变量(推荐)curl -X GET "https://api.deepseek.com/v1/models" -H "Authorization: Bearer $DEEPSEEK_API_KEY"
成功响应为JSON数组,含 id、name 等字段;若返回 {"error": {"message": "Invalid authorization header"}},说明密钥格式错误(如多空格、换行符、前缀漏写 Bearer )。
调用文本生成接口(POST)
该请求需完整构造JSON body,并设置正确Content-Type与认证头:
第一步:准备最小化请求体
创建文件 payload.json,内容为:
{"model": "deepseek-chat", "messages": [{"role": "user", "content": "你好"}], "max_tokens": 64}
第二步:发送请求curl -X POST "https://api.deepseek.com/v1/chat/completions" \-H "Authorization: Bearer $DEEPSEEK_API_KEY" \-H "Content-Type: application/json" \-d @payload.json
注意:-d 后必须跟 @ 符号再接文件名,否则curl会把文件名当字符串发送;若直接内联JSON,请确保双引号转义正确,例如:-d '{"model":"deepseek-chat","messages":[{"role":"user","content":"你好"}]}'。
第三步:检查响应
成功返回包含 choices[0].message.content 字段的JSON;若报错 "error":{"code":"invalid_request_error","message":"Missing required parameter: messages"},说明payload结构缺失关键字段,需对照文档校验字段层级与拼写。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!









