报错排查 · 404

404:先分清是「路径错」还是「模型错」

404 只有两种可能:URL 拼错了,或者你要的模型在你的分组里不存在。响应体里有没有 model 字样就能区分。

两类 404

响应体特征原因处理
纯 HTML 或 404 Not Found(nginx)URL 路径错误检查 base_url 是否多写/少写 /v1
JSON,含 model / model_not_found模型不在分组换分组或换模型名

路径对照表

客户端要填的值它自己拼的路径
NextChathttps://hardysapi.com/v1/chat/completions
Chatbox / Cherry Studio / Cline / Difyhttps://hardysapi.com/v1/chat/completions
沉浸式翻译https://hardysapi.com/v1/chat/completions直接用
Anthropic 原生https://hardysapi.com/v1/messages
⚠️ 出现 /v1/v1/chat/completions 就是这个客户端自己会补 /v1,把填的值去掉结尾的 /v1。

模型名核对

模型名区分大小写、含版本后缀。直接从 模型价格 复制,或用接口拉一份当前分组可用的清单:

列出当前密钥可用模型bash
curl https://hardysapi.com/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

返回列表里没有的模型,无论名字多正确都会 404。

常见问题

404 是模型不存在还是地址写错?

看响应体:返回 HTML 或 nginx 错误页是路径问题;返回 JSON 且提到 model 是模型不在当前分组。

为什么文档里有的模型我调不到?

模型可用范围由密钥所属分组决定,分组里没有的模型会 404,需要换分组。