model not found 和 /v1/v1 都属于配置型错误。反复充值、重建 Key 或提高重试次数通常没有用,应该先核对模型 ID 和最终请求地址。
开始前检查
记录客户端实际发送的完整 URL 和模型字段。不要只看设置页面里填写了什么,因为客户端可能会自动追加路径或替换模型别名。
配置步骤
获取真实模型 ID
curl https://www.aifast.club/v1/models \
-H "Authorization: Bearer $AIFAST_API_KEY"
从返回结果复制 id 字段。以下内容通常不能直接当模型 ID:
- 网页卡片标题。
- 中文模型名称。
- 厂商名称。
- “最新”“旗舰”“高速”等营销标签。
检查最终 URL
正确的 Chat Completions 请求通常类似:
https://www.aifast.club/v1/chat/completions
错误示例:
https://www.aifast.club/v1/v1/chat/completions
https://www.aifast.club/chat/completions
https://www.aifast.club/v1/models/chat/completions
如果客户端自动追加 /v1,Base URL 就填写根域名;如果客户端要求完整兼容地址,则保留 /v1。
常见问题
模型列表里有,但调用仍然不存在
模型可能只支持特定接口或当前账号权限不同。核对模型是否支持 Chat Completions、Responses、图像或视频任务,不要用文本接口调用非文本模型。
404 返回的是网页 HTML
说明请求可能落到了前端站点,而不是 API 路由。检查 Host、路径和反向代理,不要把 HTML 错误页当作模型返回。
工具自动把模型名改掉
部分客户端只允许内置模型或会把显示名称映射到固定 ID。查看请求日志确认最终发送值;必要时使用客户端提供的自定义模型功能。
下一步
修正模型名和地址后,用非流式短请求验证。短请求成功后,再恢复工具调用、长上下文和流式输出。