模型配置 API

管理 LLM 模型配置，支持自定义 OpenAI 兼容端点与本地模型。

版本说明：模型接口位于 V4 前缀 /api/v4/llm/*（企业版另注册别名 /api/v1/v4/llm/*）。/api/v4/llm/models/:name/default 与连通性测试端点为个人版独有。

---

GET /api/v4/llm/models

列出当前已配置的模型。

响应：

{
  "code": 0,
  "data": {
    "items": [
      {
        "name": "lyncore-chat",
        "provider": "relay",
        "base_url": "https://relay.lyncore.cn/v1",
        "is_default": true,
        "status": "active"
      },
      {
        "name": "my-ollama-qwen",
        "provider": "local",
        "base_url": "http://localhost:11434/v1",
        "is_default": false,
        "status": "active"
      }
    ],
    "total": 2
  },
  "message": "ok",
  "request_id": "req_abc123"
}

出厂模型：个人版默认通过 relay.lyncore.cn 中继访问出厂模型，首次使用需联网激活。

---

POST /api/v4/llm/models

新增模型配置。

字段	类型	必填	说明
name	string	✅	模型标识（用于对话 model 字段）
provider	string	✅	类型：openai、anthropic、deepseek、zhipu、local、custom 等
base_url	string	-	自定义 API 地址（OpenAI 兼容）
api_key	string	-	API 密钥（本地模型可留空）
is_default	bool	-	是否设为默认，默认 false

curl -X POST http://localhost:19824/api/v4/llm/models \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-ollama-qwen",
    "provider": "local",
    "base_url": "http://localhost:11434/v1",
    "is_default": false
  }'

本地 / Ollama 模型：Lyncore 没有独立的 ollama provider 开关。接入 Ollama 等本地推理服务，使用 provider: "local"（或 direct），并将 base_url 指向其 OpenAI 兼容端点，例如 http://localhost:11434/v1。这也是离线使用本地模型的唯一方式。

---

PUT /api/v4/llm/models/:name

更新指定模型配置（按 name）。字段同新增（均可选）。

---

DELETE /api/v4/llm/models/:name

删除模型配置。

---

PUT /api/v4/llm/models/:name/toggle

启停某模型（启用/禁用）。

---

PUT /api/v4/llm/models/:name/default

个人版独有。将某模型设为默认。

---

POST /api/v4/llm/chat

直连 LLM 补全（绕过对话/Agent 编排，直接走模型网关）。

---

连通性测试（个人版独有）

方法	路径	说明
POST	/api/v4/llm/models/test	用临时凭证测试连通性
POST	/api/v4/llm/models/:name/test	用已存凭证测试连通性

---

错误码

场景	code	message
模型不存在	40400	模型不存在
API Key 无效	40001	API Key 验证失败
供应商/类型不支持	40001	不支持的 provider