喵维斯 Meowvis

🚀 快速开始

欢迎使用喵维斯 API！通过以下步骤，你可以快速集成喵维斯的AI对话能力到你的应用。

获取你的 API Token

你的 Access Token

加载中...

⚠️ Token有过期时间，如失效请重新登录获取

调用示例 (cURL)

curl -X POST "https://api.meowvis.ai/api/v1/chat/message" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"message": "你好", "model": "auto"}'

import requests

response = requests.post(
    "https://api.meowvis.ai/api/v1/chat/message",
    headers={
        "Authorization": "Bearer YOUR_TOKEN_HERE",
        "Content-Type": "application/json"
    },
    json={"message": "你好", "model": "auto"}
)
print(response.json())

const response = await fetch('https://api.meowvis.ai/api/v1/chat/message', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_TOKEN_HERE',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({ message: '你好', model: 'auto' })
});
const data = await response.json();
console.log(data);

请求基础信息

Base URL: /api/v1
认证方式: Bearer Token (JWT)
Content-Type: application/json

🔐 认证方式

所有API请求都需要在请求头中携带有效的 Access Token。

获取 Token

POST /api/v1/auth/login

通过用户名和密码登录，获取访问令牌

请求参数 (form-data)

usernamestring 用户名

passwordstring 密码

认证请求示例

# 登录获取Token
curl -X POST "https://api.meowvis.ai/api/v1/auth/login" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=your_username&password=your_password"

# 响应示例
# {"access_token": "eyJhbGciOiJIUzI1NiIs...", "token_type": "bearer"}

# 使用Token访问API
curl -X GET "https://api.meowvis.ai/api/v1/billing/usage/user" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

import requests

# 登录获取Token
login_data = {
    "username": "your_username",
    "password": "your_password"
}
resp = requests.post(
    "https://api.meowvis.ai/api/v1/auth/login",
    data=login_data
)
token = resp.json()["access_token"]

# 使用Token访问API
headers = {"Authorization": f"Bearer {token}"}
usage = requests.get(
    "https://api.meowvis.ai/api/v1/billing/usage/user",
    headers=headers
)
print(usage.json())

// 登录获取Token
const loginResp = await fetch('https://api.meowvis.ai/api/v1/auth/login', {
    method: 'POST',
    headers: {'Content-Type': 'application/x-www-form-urlencoded'},
    body: 'username=your_username&password=your_password'
});
const { access_token } = await loginResp.json();

// 使用Token访问API
const usage = await fetch('https://api.meowvis.ai/api/v1/billing/usage/user', {
    headers: {'Authorization': `Bearer ${access_token}`}
});
console.log(await usage.json());

💡 Token有效期为24小时，过期后需要重新登录获取。建议将Token存储在环境变量中。

💬 对话接口

使用以下接口与AI进行对话交互。

发送消息 (普通模式)

POST /api/v1/chat/message

发送消息并获取AI回复（非流式）

请求体

messagestring 消息内容 (必填)

modelstring 模型: auto/ollama/openai (默认auto)

filesarray 附件文件URL列表 (可选)

curl -X POST "https://api.meowvis.ai/api/v1/chat/message" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "解释一下量子计算",
    "model": "auto"
  }'

# 响应示例
# {
#   "response": "量子计算是一种遵循量子力学规律调控量子信息单元...",
#   "tokens_used": 128,
#   "model": "deepseek"
# }

import requests

resp = requests.post(
    "https://api.meowvis.ai/api/v1/chat/message",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={
        "message": "解释一下量子计算",
        "model": "auto"
    }
)
result = resp.json()
print(f"回复: {result['response']}")
print(f"消耗Tokens: {result['tokens_used']}")

const resp = await fetch('https://api.meowvis.ai/api/v1/chat/message', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        message: '解释一下量子计算',
        model: 'auto'
    })
});
const result = await resp.json();
console.log(`回复: ${result.response}`);
console.log(`消耗Tokens: ${result.tokens_used}`);

发送消息 (流式)

POST /api/v1/chat/stream

发送消息并获取AI回复（流式，适合实时显示打字效果）

请求体

messagestring 消息内容

modelstring 模型选择

curl -X POST "https://api.meowvis.ai/api/v1/chat/stream" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "写一首诗", "model": "openai"}'

# 响应为 Server-Sent Events (SSE)
# data: {"content": "春", "done": false}
# data: {"content": "江", "done": false}
# data: {"content": "水", "done": false}
# ...
# data: {"content": "。", "done": true, "tokens_used": 256}

import requests
import json

with requests.post(
    "https://api.meowvis.ai/api/v1/chat/stream",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={"message": "写一首诗", "model": "openai"},
    stream=True
) as resp:
    for line in resp.iter_lines():
        if line:
            data = json.loads(line.decode('utf-8').replace('data: ', ''))
            if data.get('content'):
                print(data['content'], end='', flush=True)
            if data.get('done'):
                print(f"\n消耗Tokens: {data.get('tokens_used')}")

获取可用模型

GET /api/v1/chat/models

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

curl -X GET "https://api.meowvis.ai/api/v1/chat/models" \
  -H "Authorization: Bearer YOUR_TOKEN"

# 响应示例
# {"models": [{"name": "Auto", "provider": ""}, {"name": "Meowvis", "provider": "ollama"}, {"name": "DeepSeek", "provider": "openai"}]}

📊 账单与用量

查询你的账户用量和套餐信息。

个人用量统计

GET /api/v1/billing/usage/user

获取当前用户的用量统计

查询参数

daysint 统计天数 (默认30)

curl -X GET "https://api.meowvis.ai/api/v1/billing/usage/user?days=30" \
  -H "Authorization: Bearer YOUR_TOKEN"

# 响应示例
# {
#   "total_calls": 156,
#   "total_tokens": 45230,
#   "total_input_tokens": 12350,
#   "total_output_tokens": 32880
# }

import requests

resp = requests.get(
    "https://api.meowvis.ai/api/v1/billing/usage/user",
    params={"days": 30},
    headers={"Authorization": "Bearer YOUR_TOKEN"}
)
usage = resp.json()
print(f"API调用次数: {usage['total_calls']}")
print(f"Token总消耗: {usage['total_tokens']}")

获取套餐列表

GET /api/v1/billing/plans

获取所有可用套餐信息

curl -X GET "https://api.meowvis.ai/api/v1/billing/plans" \
  -H "Authorization: Bearer YOUR_TOKEN"

# 响应示例
# {
#   "plans": {
#     "free": {"name": "免费版", "price_monthly": 0, "included_tokens": 100000},
#     "basic": {"name": "基础版", "price_monthly": 29, "included_tokens": 1000000}
#   }
# }

🤖 AI 模型说明

喵维斯支持多种AI模型，你可以根据需求选择合适的模型。

🎯

Auto · 智能选择

model: auto

系统自动选择最适合当前任务的模型。适合不确定该用哪个模型的用户，简单省心。

🏠

Meowvis · 本地模型

model: ollama

本地部署的Ollama模型，响应速度快，无需联网。适合简单对话、代码补全等日常任务。完全免费使用。

☁️

DeepSeek · 云端模型

model: openai

调用DeepSeek云端API，能力强大，适合复杂推理、创意写作、长文本处理等任务。消耗Token配额。

模型选择建议

日常闲聊、简单问答 → 使用 Meowvis (本地)，免费快速
代码编写、数据分析 → 使用 DeepSeek (云端)，能力更强
不确定需求 → 使用 Auto，系统自动匹配

💡 不同模型消耗的Token数量不同，DeepSeek云端模型能力强但消耗更多配额。

你好，我是喵维斯

个人中心

📖 API 文档