用 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 |
上游临时繁忙或故障 | 稍等再试;持续出现请联系客服 |
最常见的三个坑
- Key 前后带了空格或换行:从聊天软件里复制时最容易出现,会导致 401。
- 用错了请求头:Anthropic 格式用
x-api-key,OpenAI 格式用Authorization: Bearer。 - Key 和模型不在同一个分组:Claude 的 Key 调不了 GPT 模型,反过来也一样。先用第 1 条命令确认。
相关页面
最后更新:2026-11-15