LyncoreLyncore
Lyncore

模型配置 API ​

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

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

GET /api/v4/llm/models ​

列出当前已配置的模型。

响应：

json
{
  "code": 0,
  "data": {
    "items": [
      {
        "name": "lyncore-flash",
        "provider": "relay",
        "base_url": "https://relay.lyncore.top/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.top 中继访问出厂模型，首次使用需联网完成本地授权激活。

POST /api/v4/llm/models ​

新增模型配置。

字段类型必填说明
namestring✅模型标识（用于对话 model 字段）
providerstring✅类型：openai、anthropic、deepseek、zhipu、local、custom 等
base_urlstring-自定义 API 地址（OpenAI 兼容）
api_keystring-API 密钥（本地模型可留空）
is_defaultbool-是否设为默认，默认 false
bash
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用已存凭证测试连通性

错误码 ​

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