REST API + MCP Server

使用视频智能构建

两种集成方式:用于自定义应用的完整REST API,以及让AI助手原生处理你的视频的MCP服务器。

REST API

完全的编程控制

一个涵盖整个视频生命周期的综合RESTful API — 从上传和编码到AI分析、转录、搜索和团队管理。

上传和导入

从YouTube导入视频或通过预签名S3 URL直接上传。编码在后台自动进行。

AI分析

提交视频进行AI分析 — 生成章节、检测场景、提取实体并生成详细摘要。

转录

使用Whisper转录音频,然后翻译成100多种语言。开箱即用的完整多语言字幕支持。

搜索和聊天

在你的库中进行混合语义+关键词搜索。为单个视频或整个集合启用基于RAG的AI聊天。

向量嵌入

从分析和转录数据生成向量嵌入,以支持语义搜索和基于RAG的AI聊天。

组织

通过基于角色的访问控制、组间数据隔离和邀请流程管理团队 — 全部通过API。

bash
curl -X POST "https://www.coniviso.com/api/v1/videos/{id}/analyze" \
  -H "Authorization: Bearer vi_live_..." \
  -H "Content-Type: application/json" \
  -d '{"analysisType": "comprehensive"}'
MCP服务器

你的视频在任何AI助手中

Coniviso提供Model Context Protocol (MCP)服务器,让Claude、Cursor等AI助手和自定义代理可以访问你的视频库、搜索内容、读取转录和触发分析 — 全部通过标准MCP接口。

什么是MCP?

Model Context Protocol是一个开放标准,允许AI模型安全地与外部工具和数据源交互。无需编写自定义集成,任何兼容MCP的AI客户端都可以连接到Coniviso并立即使用你的视频作为上下文。

21个可用工具

每个工具都受限于您的API密钥权限。您的AI助手可以列出、搜索、更新和删除视频,管理组织、团队、权限和可见性,检索分析和转录,与单个视频或整个库聊天,生成嵌入,以及提交新的分析任务 — 全部无需离开对话。

  • list_videos使用分页和状态过滤器浏览你的视频库
  • get_video获取任何视频的完整元数据、处理状态和配置
  • search_videos在所有可访问视频中进行混合语义+关键词搜索
  • chat_with_library使用RAG对整个视频集合提问
  • chat_with_video关于特定视频的问答,支持多轮对话
  • get_analysis检索AI分析结果:摘要、章节、场景、实体
  • get_transcription获取转录数据,可选按语言过滤
  • analyze_video提交视频进行AI分析(综合、场景、对象或文本)
  • generate_embeddings从分析和转录数据创建向量嵌入以支持语义搜索
  • update_video更新视频的标题、描述、可见性或组织
  • delete_video永久删除视频及所有关联数据
  • get_permissions列出视频上授予的所有访问权限
  • grant_permission向用户、组或组织授予视频访问权限
  • revoke_permission撤销之前授予的视频访问权限
  • list_organizations返回您所属的组织列表
  • get_organization返回特定组织的详细信息
  • list_org_members返回组织的所有成员
  • invite_org_member邀请成员加入组织
  • remove_org_member从组织中移除成员
  • list_org_groups列出组织内的所有组
  • list_group_members列出组织内特定组的所有成员

8个资源

MCP资源让AI助手以结构化上下文直接访问你的视频数据:

  • coniviso://videos包含元数据的所有可访问视频的完整列表
  • coniviso://video/:id包括分析和转录在内的完整视频详情
  • coniviso://video/:id/transcription特定视频的完整转录数据
  • coniviso://video/:id/analysisAI分析结果:摘要、章节、场景、实体
  • coniviso://video/:id/permissions显示已授权权限的访问控制列表
  • coniviso://organizations您所属的所有组织的列表
  • coniviso://organization/:id组织详细信息及其成员列表
  • coniviso://organization/:id/groups组织内所有组的列表

30秒连接

用单个配置块将Coniviso添加到任何MCP客户端。使用你现有的API密钥进行身份验证。

端点https://www.coniviso.com/mcp
身份验证Bearer vi_live_...
传输Streamable HTTP(HTTP上的JSON-RPC)

每个会话获得自己的隔离服务器实例。会话通过mcp-session-id头标识。

mcp config
{
  "mcpServers": {
    "coniviso": {
      "url": "https://www.coniviso.com/mcp",
      "headers": {
        "Authorization": "Bearer vi_live_..."
      }
    }
  }
}
开始使用

几分钟即可运行

1. 创建API密钥

在Coniviso仪表板中转到设置→API密钥。API密钥遵循vi_live_*格式,可以设置细粒度权限。

2. 验证请求

在Authorization头中包含你的API密钥作为Bearer令牌。适用于REST API调用和MCP连接。

3. 开始构建

从任何语言使用REST API,或将MCP服务器连接到你的AI助手。两者共享相同的API密钥和权限。

可用权限

  • videos:read列出和读取视频元数据
  • videos:write上传、更新和删除视频
  • analysis提交和读取AI分析结果
  • search搜索视频内容
  • chat使用AI聊天功能(按视频和全库)
  • embeddings生成和管理向量嵌入

准备好集成了吗?

开始使用Coniviso API和MCP服务器构建。免费计划包含60分钟AI处理。