model_not_found 怎么解决
最后更新:
结合 HTTP 状态与 error.code 区分模型发现失败、路径 404 与临时服务不可用,核对精确 ID、Key 模型范围和当前上架信息。
按 HTTP 状态与 error.code 分流
客户端弹窗、HTTP 状态和 JSON 错误码应一起核对。以下状态是分流线索,最终以该请求返回的结构与日志为准。
| HTTP | error.code / 现象 | 下一步 |
|---|---|---|
| GET /v1/models/{model_id} → 200 | model_not_found | 模型发现 GET /v1/models/{model_id} 可用 HTTP 200 返回 error.code=model_not_found;先解析 JSON 错误,再判断是否找到模型。 |
| POST /v1/chat/completions → 404 | model_not_found | 复制精确模型 ID;核对当前模型页、Key 模型限制和账号分组。生成请求的公开错误也可能包含不可用 endpoint,不能仅凭状态认定模型下架。 |
| 503 | model_temporarily_unavailable | 这是临时服务不可用的公开错误,按服务状态排查,不能据此认定 ID 不存在。 |
| 404 | 缺失或需另查 | 若响应是 HTML 或没有 error.code,先查实际 URL;路径 404 不能认定模型下架。 |
安全采集一次最小诊断
这段代码关闭 SDK 自动重试,只输出状态、错误码与请求 ID;它不会读取或打印账户余额。请保留原模型复现,诊断确认后再修配置。
第二段代码单独检查模型发现结果,先检查 error 再判断 model_found;HTTP 200 本身不代表模型存在。模型发现成功也不能替代一次生成调用验收。
import os
from openai import OpenAI, APIStatusError, APIConnectionError, APITimeoutError
client = OpenAI(api_key=os.environ["KKAI_API_KEY"],
base_url="https://api.kkaiapi.com/v1", max_retries=0, timeout=120)
try:
r = client.chat.completions.create(
model="claude-sonnet-5-5", messages=[{"role": "user", "content": "请只回复 pong"}])
print("ok", r.model)
except APIStatusError as exc:
try:
payload = exc.response.json()
error = payload.get("error", {}) if isinstance(payload, dict) else {}
error_code = error.get("code") if isinstance(error, dict) else None
except ValueError:
error_code = None
print({"status": exc.status_code, "code": error_code,
"request_id": exc.response.headers.get("x-request-id")})
except (APIConnectionError, APITimeoutError) as exc:
print({"transport_error": type(exc).__name__})import json
import os
import requests
model_id = os.environ.get("KKAI_MODEL_ID", "claude-sonnet-5-5")
r = requests.get("https://api.kkaiapi.com/v1/models/" + model_id,
headers={"Authorization": "Bearer " + os.environ["KKAI_API_KEY"]}, timeout=30)
try:
payload = r.json()
except ValueError:
payload = {}
error = payload.get("error", {}) if isinstance(payload, dict) else {}
error_code = error.get("code") if isinstance(error, dict) else None
model_found = (r.status_code == 200 and not error and
isinstance(payload, dict) and payload.get("id") == model_id)
print(json.dumps({"status": r.status_code, "code": error_code,
"request_id": r.headers.get("x-request-id"), "model_found": model_found}))逐字核对 ID 与可见范围
从当前模型页复制 API ID,保留大小写、点号和版本后缀。展示名和其他平台的别名不是这里的模型 ID。对同一 Key 核对模型限制;上架状态、模型权限和可用路由是不同条件。
保留可分享的诊断信息
只记录时间、模型 ID、请求路径、HTTP 状态、error.code 和请求 ID。分享截图前遮掉 Authorization、x-api-key、Cookie、完整 Key、支付信息与请求中的私人内容;不要开启会输出请求头的调试日志。
常见问题
可以直接重复请求吗?
配置、权限或额度错误先修正再重试。临时错误采用有上限的退避;超时和断流先确认已执行结果,异步视频保留 task_id 查询。