API 文档 · MeowVis

参数	值
Base URL	`https://meowvis.com/api/v1`
认证方式	Bearer Token（登录获取）
请求格式	`application/json`
返回格式	`application/json`

认证方式

所有 API 请求需在 Header 中携带 Bearer Token：

Authorization: Bearer <your_token>

获取 Token

通过登录接口获取 access_token：

POST /auth/login

参数	类型	必填	说明
`username`	string	是	用户名
`password`	string	是	密码

curl

Python

curl -X POST https://meowvis.com/api/v1/auth/login \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=your_username&password=your_password"

import requests

resp = requests.post("https://meowvis.com/api/v1/auth/login",
    data={"username": "your_username", "password": "your_password"})
token = resp.json()["access_token"]
# 保存 token 供后续使用
headers = {"Authorization": f"Bearer {token}"}

Token 有效期为 24 小时，过期后请重新登录或使用 /auth/refresh 刷新。

可用模型

通过 GET /chat/models 查询当前可用模型列表：

模型 ID	名称	Provider	说明
`deepseek-v4-pro`	DeepSeek V4 Pro	OpenAI	最强推理能力
`deepseek-v4-flash`	DeepSeek V4 Flash	OpenAI	快速响应
`mimo-v2.5-pro`	MiMo V2.5 Pro	OpenAI	小米MiMo旗舰模型，强大推理能力
`mimo-v2-flash`	MiMo V2 Flash	OpenAI	小米MiMo快速响应模型
`meowvis-local`	Meowvis	Ollama	本地模型，自动选择文字(qwen2.5:7b)或视觉(llava:7b)

对话 API

发送消息并获取 AI 回复，支持指定模型和多轮对话。

POST /chat/message

请求参数

参数	类型	必填	说明
`message`	string	是	用户消息内容
`conversation_id`	string	否	对话ID，不传则新建对话
`model`	string	否	指定模型，默认 deepseek-v4-pro

代码示例

curl

Python

Node.js

curl -X POST https://meowvis.com/api/v1/chat/message \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "message": "你好，介绍一下你自己",
    "model": "deepseek-v4-pro"
  }'

import requests

resp = requests.post("https://meowvis.com/api/v1/chat/message",
    headers={"Authorization": f"Bearer {token}"},
    json={
        "message": "你好，介绍一下你自己",
        "model": "deepseek-v4-pro"
    })

data = resp.json()
print(data["response"])

const resp = await fetch("https://meowvis.com/api/v1/chat/message", {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "Authorization": `Bearer ${token}`
    },
    body: JSON.stringify({
        message: "你好，介绍一下你自己",
        model: "deepseek-v4-pro"
    })
});

const data = await resp.json();
console.log(data.response);

响应格式

{
  "response": "你好！我是喵维斯，一个AI智能助手...",
  "conversation_id": "conv_abc123",
  "model_used": "deepseek-v4-pro",
  "tools_used": [],
  "processing_time": 1.23
}

流式对话

使用 Server-Sent Events (SSE) 流式返回，适合实时显示回复的场景。

POST /chat/stream

请求参数与 /chat/message 相同，响应为 SSE 流：

data: {"token": "你", "done": false}

data: {"token": "好", "done": false}

data: {"token": "！", "done": false}

data: {"done": true, "conversation_id": "conv_abc123"}

Python 流式示例

import requests

resp = requests.post("https://meowvis.com/api/v1/chat/stream",
    headers={"Authorization": f"Bearer {token}"},
    json={"message": "讲个笑话"},
    stream=True)

for line in resp.iter_lines():
    if line:
        text = line.decode("utf-8")
        if text.startswith("data: "):
            import json
            chunk = json.loads(text[6:])
            if chunk.get("token"):
                print(chunk["token"], end="", flush=True)

对话管理

GET /chat/conversations

获取当前用户的所有对话列表。

GET /chat/history/{conversation_id}

获取指定对话的完整历史消息。

POST /chat/models

获取当前可用的模型列表。

GET /chat/tools

获取系统已注册的工具列表（搜索、计算、天气等）。

知识库检索

搜索 MeowVis 向量知识库，获取相关知识和上下文。

POST /knowledge/search

参数	类型	必填	说明
`query`	string	是	搜索内容
`top_k`	int	否	返回条数，默认5

curl

Python

curl -X POST https://meowvis.com/api/v1/knowledge/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "query": "如何配置Nginx",
    "top_k": 3
  }'

resp = requests.post("https://meowvis.com/api/v1/knowledge/search",
    headers={"Authorization": f"Bearer {token}"},
    json={"query": "如何配置Nginx", "top_k": 3})

for result in resp.json()["results"]:
    print(f"[{result['score']:.2f}] {result['content'][:100]}")

响应格式

{
  "results": [
    {
      "content": "Nginx反向代理配置方法...",
      "score": 0.92,
      "source": "nginx_docs.md"
    }
  ],
  "total": 1
}

错误码

状态码	说明
`200`	请求成功
`400`	请求参数错误
`401`	未认证或 Token 过期
`403`	权限不足
`404`	资源不存在
`429`	请求频率超限
`500`	服务器内部错误
`502`	网关错误（服务暂不可用）

错误响应格式

{
  "detail": "用户名或密码错误"
}

限速说明

项目	限制
普通用户	20 次/分钟
VIP 用户	100 次/分钟
流式对话	10 次/分钟
知识库检索	30 次/分钟

超过限速将返回 429 状态码，请等待后重试。

更新日志

版本	日期	更新内容
v1.0	2026-06-25	API 文档发布，支持对话/流式/知识库检索
v1.1	2026-06-25	首页全面重写（DeepSeek风格白色极简）、动态数据实时同步、GitHub改为客户端下载
v1.2	2026-06-25	登录页DeepSeek风格重设计、Auth API开发(注册/忘记密码/验证码登录)、Go网关崩溃修复、导航栏调整、Logo去除~_前缀、登录页增加返回首页按钮
v1.3	2026-06-25	登录后页面DeepSeek风格重设计：白色极简聊天界面、模式切换(快速/专家/识图)、深度思考/智能搜索功能按钮、侧边栏重设计
v1.4	2026-06-25	微信风格聊天气泡(用户蓝色右/AI灰色左)、侧边栏折叠浮动按钮、模型选择器修复、智能搜索改联网搜索+后端web_search、深度思考功能+后端deep_think、附件发送修复、清空对话白色空状态
v1.5	2026-06-25	AI免责声明、统一气泡背景色(浅灰#f1f5f9)、用户头像SVG、移除工具按钮(默认常开)、模型下拉fixed弹出+精简(隐藏provider)、用户中心4页面重设计(通用/账号/数据/协议)、合并本地模型为Meowvis(自动选择vision/text)、下拉框宽度优化
v1.6	2026-06-25	模型选择按钮文字丢失修复(selectModelById)、下拉框宽度优化(150px+nowrap+全称)、首页"了解更多"改为"API 开放平台"、账号管理增加头像上传+昵称修改、侧边栏联动显示自定义头像/昵称、清空对话暗色bug修复、docs.html模型表更新(合并Meowvis)、llava:7b视觉模型安装
v1.8	2026-06-26	知识引擎stats API修复(KnowledgeEngine.get_stats属性错误)、数据优化开关后端对接(toggleDataOpt同步用户配置)、GET /me返回data_opt
v1.9	2026-06-26	管理后台新增7个功能页面(知识库/对话/自主系统/工作流/系统监控/用量/审计)、systemd服务防重启循环(ExecStartPre清端口+KillMode=control-group)、对话页欢迎屏不消失修复(empty-state display !important移除)、深色主题强制切回浅色(system->light)
v1.7	2026-06-25	MIMO API对接(mimo-v2.5-pro/flash)、BaseHTTPMiddleware死锁修复(纯ASGI中间件)、_load_users返回值修复、security/rules 500修复(IPControlConfig.get_ip_list)、头像上传/昵称修改端到端修复

MeowVis API

认证方式

获取 Token

可用模型

对话 API

请求参数

代码示例

响应格式

流式对话

Python 流式示例

对话管理

知识库检索

响应格式

错误码

错误响应格式

限速说明

更新日志