“模型不存在”是因模型id在接口上下文中不可见，需依次验证模型列表、核对baseurl/api key/模型名三参数、排查环境变量覆盖，并通过hermes setup --force重配或hermes model交互绑定，最后用hermes chat -q "hi"验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space API调用时提示“模型不存在”，不是服务宕机或网络问题，而是当前请求的模型ID在指定接口上下文中不可见，常见于模型名拼写错误、账号权限不匹配、BaseURL未指向正确服务端点、或配置被环境变量静默覆盖。
先确认模型是否存在且可访问
打开浏览器或终端，用 curl 直接请求供应商的模型列表接口，不经过 Agent Space 中间层：
curl -H "Authorization: Bearer 【你的API Key】" https://your-base-url/v1/models
如果返回 401，说明 API Key 无效或权限不足；如果返回空数组或 404，说明 BaseURL 错误或该账号下确实没有可用模型；只有返回包含目标模型名的 JSON 列表，才证明模型存在且可被当前凭证调用。
检查 Agent Space 配置中的三项核心参数
Agent Space 的模型接入依赖三个强绑定参数：BaseURL、API Key、模型名。三者必须与供应商文档完全一致，缺一不可。
第一步：执行命令查看当前生效配置
hermes config show
第二步：核对输出中 model 区块下的 base_url、api_key、default 字段值
base_url 必须以 https:// 开头、末尾不含 /、路径精确到 /v1 或 /v1/chat/completions（取决于供应商要求）；
api_key 必须为 sk- 开头、32位以上、无引号包裹、无换行；
default 值必须与 curl 获取的模型列表中 name 字段完全一致，包括大小写、连字符和版本后缀。
第三步：重点检查是否被环境变量劫持
运行 hermes dump --show-keys，若输出中显示 HERMES_API_KEY 或 HERMES_MODEL_PROVIDER 已设置，则这些变量会强制覆盖 config.yaml 内容，必须清空对应环境变量再重试。
手动触发模型注册向导
方法一：交互式绑定
在终端运行 hermes model → 选择 Custom endpoint (OpenAI compatible) → 粘贴 BaseURL（如 https://dashscope.aliyuncs.com/compatible-mode/v1）→ 输入 API Key → 填写模型名（如 qwen-plus）→ 确认后等待 Model successfully configured 提示。
方法二：跳过自动检测，强制写入
执行 hermes setup --force，该命令会忽略已有配置，重新生成完整 config.yaml 并引导你逐项填写，避免缩进错误或字段缺失导致解析失败。
【注意：setup --force 会清除原有配置，请提前备份 config.yaml】
验证模型是否真正加载成功
运行 hermes chat -q "hi"，观察终端是否立即返回响应内容。
若仍报错 model not found，说明配置未生效；
若返回响应但内容异常（如格式错乱、缺少 tool_calls 字段），则问题不在模型存在性，而在响应协议兼容性，需检查供应商是否返回标准 OpenAI Chat Completions 格式。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
