meicut 开发者文档

通过 REST API 或 MCP 协议接入 meicut 视频处理能力，在你的应用中集成视频剪辑、格式转换、压缩等功能。

REST API

标准 HTTP 接口，支持所有主流编程语言接入

MCP 协议

Model Context Protocol，AI 原生接入方式

20+ 工具

视频剪辑、合并、压缩、格式转换、音频处理等

快速接入

1

创建应用

登录 meicut 控制台，进入「开发者中心」，创建一个应用。创建后你将获得 API Key。

2

上传文件

通过 API 上传视频/音频/图片文件，获取 stored_name 用于后续处理。

3

调用工具

使用 stored_name 调用具体的视频/音频处理工具，获得 job_id。

4

获取结果

通过 job_id 轮询任务状态，处理完成后获取 download_url。

认证方式

所有 API 请求需要在请求头中携带 API Key：

HTTP Header
X-API-Key: mv_your_api_key_here

API Key 在控制台「开发者中心」创建应用后获取。每个 API Key 绑定一个用户账号，所有费用从该账号余额中扣除。

文件上传

POST/api/v1/upload

上传媒体文件（视频/音频/图片），返回 stored_name 供后续工具使用。

请求

curl
curl -X POST https://your-domain/api/v1/upload \
  -H "X-API-Key: mv_your_api_key" \
  -F "file=@/path/to/video.mp4"

响应

JSON
{
  "file_id": "uuid",
  "filename": "video.mp4",
  "stored_name": "uuid.mp4",
  "size": 10485760,
  "media_info": { "duration": 30.5, "width": 1920, "height": 1080 }
}

视频工具

POST/api/v1/video-tool

支持 14 种视频处理操作，通过 tool 参数指定：

请求示例 - 视频裁剪

curl
curl -X POST https://your-domain/api/v1/video-tool \
  -H "X-API-Key: mv_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "stored_name": "uuid.mp4",
    "tool": "cut-video",
    "params": { "start_time": 5, "duration": 10 }
  }'

合并视频

POST/api/v1/video-tool/merge
JSON
{
  "stored_names": ["uuid1.mp4", "uuid2.mp4"],
  "params": { "resolution_mode": "auto" }
}

音频工具

POST/api/v1/audio-tool
POST/api/v1/audio-tool/merge

格式转换

POST/api/v1/convert-tool

视频压缩

POST/api/v1/compress
JSON
{
  "stored_name": "uuid.mp4",
  "quality": "medium",
  "resolution": "720p",
  "remove_audio": false
}

quality: low / medium / high

resolution: original / 1080p / 720p / 480p

任务状态查询

GET/api/v1/job/{job_id}/status
响应
{
  "job_id": "uuid",
  "status": "completed",
  "progress": 100,
  "output_file": "exports/uuid.mp4",
  "download_url": "http://minio-endpoint/meicut-files/exports/uuid.mp4?X-Amz-..."
}

status 值：processing | completed | failed

MCP 协议说明

meicut 支持 Model Context Protocol (MCP)，允许 AI 助手（如 Claude、Cursor 等）直接调用视频处理能力。

MCP 是一种标准化协议，让 AI 模型能够发现和调用外部工具。meicut MCP Server 暴露了 22 个工具，覆盖所有视频/音频处理功能。

SSE 接入地址

URL
https://your-domain/mcp/sse?api_key=mv_your_api_key

MCP 工具列表

MCP 接入示例

Cursor / Claude Desktop 配置

在 MCP 配置文件中添加：

JSON (mcp.json)
{
  "mcpServers": {
    "meicut": {
      "url": "https://your-domain/mcp/sse?api_key=mv_your_api_key"
    }
  }
}

使用流程

  1. AI 助手自动发现可用工具列表
  2. 调用 upload_file 上传文件，获取 stored_name
  3. 调用具体工具（如 cut_video、compress_video），获取 job_id
  4. 调用 get_job_status 查询处理进度和结果

计费说明

API 调用从应用所属用户账号额度中扣除。每次工具调用消耗 1 个配额（quota），具体配额额度与计费规则取决于用户订阅的开发者套餐，可通过 GET /api/pricing/plans 接口查询当前套餐与配额剩余。

文件上传不消耗配额。配额不足时调用将返回 402 错误。

错误码