用 curl 测试 AI API:OuraiC 第一次请求与返回结果检查

客户端报错时,先用 curl 发一个最小请求,可以减少界面设置的干扰。下面使用 OuraiC 的 OpenAI 兼容地址,不包含真实密钥。模型应从当前令牌可用列表选择;本文没有把示例写成已经成功的实测记录。

用 curl 测试 AI API:OuraiC 第一次请求与返回结果检查,OuraiC 配置与检查要点示意图

图:按本文操作要点制作的说明图,不是后台或调用成功截图。

准备参数

以下命令适用于 Bash。读取 Key 时关闭回显,避免把完整密钥直接写入命令历史:

read -s -p "OuraiC API Key: " OURAIC_API_KEY
printf '\n'
export OURAIC_API_KEY
read -p "可用 Model ID: " OURAIC_MODEL
export OURAIC_MODEL

首次测试不要添加图片、工具调用和长历史,先只验证短文本。

构造请求并调用

python3 - <<'JSON' > request.json
import os, json
print(json.dumps({
  "model": os.environ["OURAIC_MODEL"],
  "messages": [{"role": "user", "content": "请只回答 OK"}],
  "stream": False
}, ensure_ascii=False))
JSON
curl --max-time 60 -sS -i \
  https://ouraic.cn/v1/chat/completions \
  -H "Authorization: Bearer $OURAIC_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

Python 生成 JSON,可以减少 shell 拼接参数的错误。认证头使用本站 Key,完整 URL 包含 /chat/completions。

怎样判断结果

成功响应应符合所选接口结构,检查 choices 中是否有内容。再看本站消费记录有没有同一时间的调用。响应成功只证明这一种请求正常,不能替代流式或 Agent 测试。

401 先查 Key;404 先查路径;模型不存在查 ID 与分组;429 先降低频率。如果返回 HTML,先确认没有进入网页路由,再处理 JSON 解析。

可选查询模型

当前分组支持列表接口时,可带同一认证头请求 https://ouraic.cn/v1/models。公共定价目录与单把 Key 的权限范围可能不同;列表是否返回不能单独决定所有调用是否可用。

转到客户端验证

curl 成功后,把同一地址、Key、模型配置到客户端。若只有客户端失败,重点检查它是否追加了路径、发送了额外参数或读取了另一把 Key。

测试结束可执行 unset OURAIC_API_KEY。向支持人员提供时间、状态码、路径和脱敏错误正文,删掉完整认证头。