用 curl 测试 API Key 能不能用

一句话结论

先用 curl https://api.9linkai.com/v1/models 带上 Key 看能不能列出模型;能列出来,说明 Key 有效。再按要用的模型发一条真实请求,确认这个 Key 所在的分组有这个模型。

复制就能用的命令

把 sk-你的密钥 换成你的 Key。Windows 用户请在 Git Bash 或 WSL 里运行;PowerShell 里的 curl 是另一个命令,参数写法不同。

1. 列出这个 Key 能用的模型

curl https://api.9linkai.com/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

2. 用 Anthropic 格式调 Claude

curl https://api.9linkai.com/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "你好"}]
  }'

3. 用 OpenAI 格式调 GPT

curl https://api.9linkai.com/v1/responses \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "content-type: application/json" \
  -d '{"model": "gpt-6.1-sol", "input": "你好"}'

返回结果怎么看

返回 含义 怎么办
正常的 JSON,里面有回复内容 Key 和模型都可用 去控制台「使用记录」核对这一笔扣费
401 Key 无效、已删除,或者复制时多了空格 到控制台重新复制 Key
404,提示 model_not_found 这个 Key 所在的分组没有这个模型,或者模型 ID 拼错了 用第 1 条命令看能用的模型 ID
404,没有 model_not_found 地址写错了,比如多写或少写了 /v1 对照上面的命令检查地址
429 请求太频繁,或者余额、额度不足 稍后重试,或者检查余额
529 / 5xx 上游临时繁忙或故障 稍等再试;持续出现请联系客服

最常见的三个坑

  1. Key 前后带了空格或换行:从聊天软件里复制时最容易出现,会导致 401。
  2. 用错了请求头:Anthropic 格式用 x-api-key,OpenAI 格式用 Authorization: Bearer。
  3. Key 和模型不在同一个分组:Claude 的 Key 调不了 GPT 模型,反过来也一样。先用第 1 条命令确认。

相关页面

最后更新:2026-11-15