用 curl 构造最小请求:快速区分客户端问题和接口问题

通过不依赖 SDK 的最小请求,定位 Base URL、请求头、模型名和 JSON 参数错误。

关键词
LALondAI 内容团队发布日期 2026-09-05
5 分钟阅读模型教程
LA
用 curl 构造最小请求:快速区分客户端问题和接口问题
curl实操方法与验收标准LondAI 内容团队

通过不依赖 SDK 的最小请求,定位 Base URL、请求头、模型名和 JSON 参数错误。

先看清 curl 的问题边界

SDK 会自动拼接路径、重试和解析响应,出错时容易掩盖真正原因。最小请求的价值是把变量缩减为请求地址、Authorization、Content-Type、model 和 messages。

落地方法与执行顺序

从平台文档复制 HTTPS 地址,用临时测试 Key 发起一个短文本非流式请求。不要在聊天记录或截图里暴露完整密钥;需要协作时只保留前后少量字符用于识别。

常见误区与安全边界

排障时不要一次加入代理、自定义参数、长提示和流式输出。变量越多,越难知道是哪一层出错;先让最小请求稳定成功,再逐项恢复真实配置。

验收标准与复盘依据

成功标准不仅是收到正文,还应确认响应模型、usage 字段和请求 ID。若 curl 成功而客户端失败,问题通常位于 SDK 配置、代理环境或客户端对响应格式的处理。