ClipVerse
HomeDownload
Pricing
Get Started
Developer ModeREST + MCP

为第三方系统开放 ClipVerse 下载与解析能力

现在同一套 API Key 同时支持 REST 接口和 MCP 工具调用。外部 SaaS、自动化平台、AI Agent 或内部服务都可以直接接入，不需要再绕浏览器页面。

管理 API Key查看 MCP 接入OpenAPI JSON
快速开始
1. 在 Dashboard 生成 `cv_` 开头的 API Key
2. REST 调用带 `Authorization: Bearer <key>`
3. MCP 客户端把端点指向 `https://clipverse.divinations.top/api/mcp`
统一认证

API Key 同时适用于 REST 和 MCP，错误 Key 会直接返回 401。

MCP 工具

支持视频解析、下载地址生成、字幕获取和批量解析。

权限分层

开发者模式支持环境变量开关，并可分别限制 REST/MCP 到指定套餐。

服务端合流

抖音等分离音视频场景会自动走服务端合并，避免无声文件。

REST Endpoints

POST/api/parse

解析视频页面，返回标题、作者、时长、视频格式、音频格式和字幕轨。

JSON Body
{
  "url": "https://www.douyin.com/video/7153585060275425572"
}
POST/api/download

基于 `formatId` 生成下载地址；当音视频分离时会自动提示需要服务端合流。

JSON Body
{
  "url": "https://www.douyin.com/video/7153585060275425572",
  "formatId": "h264_1080p",
  "type": "video",
  "audioFormatId": "audio_128k"
}
POST/api/subtitles

获取字幕和自动字幕轨道。

JSON Body
{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
POST/api/batch

批量解析，单次最多 10 条 URL。

JSON Body
{
  "urls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "https://www.bilibili.com/video/BV1GJ411x7h7"
  ]
}

Authentication

浏览器站内流程继续支持 Session。第三方服务建议统一使用 Bearer API Key。若请求头里显式带了错误 Key，接口会直接返回 `401 Invalid API key`。

Authorization: Bearer CLIPVERSE_API_KEY

环境变量：
`ENABLE_DEVELOPER_MODE=true`
`DEVELOPER_REST_ALLOWED_PLANS=lifetime,team`
`DEVELOPER_MCP_ALLOWED_PLANS=lifetime,team`

cURL Example

curl -X POST "https://clipverse.divinations.top/api/parse" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLIPVERSE_API_KEY" \
  -d '{
    "url": "https://www.douyin.com/video/7153585060275425572"
  }'

MCP Endpoint

ClipVerse 现已提供轻量 HTTP MCP 端点，适合 Agent、自动化编排平台和 AI 工作流直接调用。

https://clipverse.divinations.top/api/mcp
可用工具
clipverse_parse_videoclipverse_get_downloadclipverse_get_subtitlesclipverse_batch_parse
鉴权方式：
`Authorization: Bearer CLIPVERSE_API_KEY`
支持 `initialize`、`tools/list`、`tools/call`
发现入口：
https://clipverse.divinations.top/.well-known/mcp
返回服务元数据、鉴权方式和工具清单，便于第三方自动发现。
1. initialize
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": {
      "name": "your-client",
      "version": "1.0.0"
    }
  }
}
2. tools/call
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clipverse_parse_video",
    "arguments": {
      "url": "https://www.douyin.com/video/7153585060275425572"
    }
  }
}
3. 客户端配置示例
{
  "mcpServers": {
    "clipverse": {
      "type": "http",
      "url": "https://clipverse.divinations.top/api/mcp",
      "headers": {
        "Authorization": "Bearer CLIPVERSE_API_KEY"
      }
    }
  }
}
4. 发现端点
GET https://clipverse.divinations.top/.well-known/mcp
5. OpenAPI 导出
GET https://clipverse.divinations.top/openapi.json
6. 仓库模板
templates/mcp/clipverse.mcp.json