REST API + MCP Server

Xây dựng với Video Intelligence

Hai cách tích hợp: REST API đầy đủ cho ứng dụng tùy chỉnh, và máy chủ MCP để trợ lý AI làm việc với video của bạn một cách tự nhiên.

Tham chiếu API Lấy API Key

REST API

Kiểm soát lập trình hoàn toàn

API RESTful toàn diện bao gồm toàn bộ vòng đời video — từ tải lên và mã hóa đến phân tích AI, phiên mã, tìm kiếm và quản lý nhóm.

Tải lên & Nhập

Nhập video từ YouTube hoặc tải lên trực tiếp qua URL S3 đã ký trước. Mã hóa diễn ra tự động ở nền.

Phân tích AI

Gửi video để phân tích bằng AI — tạo chương, phát hiện cảnh, trích xuất thực thể và tạo tóm tắt chi tiết.

Phiên mã

Phiên mã âm thanh bằng Whisper, sau đó dịch sang hơn 100 ngôn ngữ. Hỗ trợ phụ đề đa ngôn ngữ đầy đủ.

Tìm kiếm & Chat

Tìm kiếm hybrid ngữ nghĩa + từ khóa trong thư viện. Bật chat AI dựa trên RAG cho video riêng lẻ hoặc toàn bộ bộ sưu tập.

Embeddings

Tạo vector embedding từ dữ liệu phân tích và phiên mã để hỗ trợ tìm kiếm ngữ nghĩa và chat AI dựa trên RAG.

Tổ chức

Quản lý nhóm với quyền truy cập theo vai trò, cô lập dữ liệu giữa các nhóm và quy trình mời — tất cả qua 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"}'

Máy chủ MCP

Video của bạn trong bất kỳ trợ lý AI nào

Coniviso cung cấp máy chủ Model Context Protocol (MCP) để trợ lý AI như Claude, Cursor và các agent tùy chỉnh có thể truy cập thư viện video, tìm kiếm nội dung, đọc phiên mã và kích hoạt phân tích — tất cả thông qua giao diện MCP tiêu chuẩn.

MCP là gì?

Model Context Protocol là tiêu chuẩn mở cho phép mô hình AI tương tác an toàn với công cụ và nguồn dữ liệu bên ngoài. Thay vì viết tích hợp tùy chỉnh, bất kỳ client AI tương thích MCP nào cũng có thể kết nối với Coniviso và sử dụng video làm ngữ cảnh ngay lập tức.

21 công cụ

Mỗi công cụ được giới hạn theo quyền API key. Trợ lý AI có thể liệt kê, tìm kiếm, cập nhật và xóa video, quản lý tổ chức, nhóm, quyền và khả năng hiển thị, lấy phân tích và phiên mã, chat với video riêng lẻ hoặc toàn bộ thư viện, tạo embedding và gửi công việc phân tích mới — tất cả mà không rời cuộc trò chuyện.

list_videosDuyệt thư viện video với phân trang và bộ lọc trạng thái
get_videoLấy metadata đầy đủ, trạng thái xử lý và cấu hình của video bất kỳ
search_videosTìm kiếm hybrid ngữ nghĩa + từ khóa trên tất cả video có thể truy cập
chat_with_libraryĐặt câu hỏi về toàn bộ bộ sưu tập video bằng RAG
chat_with_videoHỏi đáp về video cụ thể với hỗ trợ hội thoại nhiều lượt
get_analysisLấy kết quả phân tích AI: tóm tắt, chương, cảnh, thực thể
get_transcriptionLấy dữ liệu phiên mã, tùy chọn lọc theo ngôn ngữ
analyze_videoGửi video để phân tích AI (toàn diện, cảnh, đối tượng hoặc văn bản)
generate_embeddingsTạo vector embedding từ dữ liệu phân tích và phiên mã cho tìm kiếm ngữ nghĩa
update_videoCập nhật tiêu đề, mô tả, khả năng hiển thị hoặc tổ chức của video
delete_videoXóa vĩnh viễn video và tất cả dữ liệu liên quan
get_permissionsLiệt kê tất cả quyền truy cập đã cấp trên video
grant_permissionCấp quyền truy cập cho người dùng, nhóm hoặc tổ chức trên video
revoke_permissionThu hồi quyền truy cập đã cấp trước đó trên video
list_organizationsTrả về danh sách tổ chức bạn tham gia
get_organizationTrả về thông tin chi tiết một tổ chức cụ thể
list_org_membersTrả về tất cả thành viên tổ chức
invite_org_memberMời một thành viên vào tổ chức
remove_org_memberXóa thành viên khỏi tổ chức
list_org_groupsCung cấp danh sách các nhóm trong tổ chức
list_group_membersCung cấp danh sách các thành viên nhóm của tổ chức

8 tài nguyên

Tài nguyên MCP cung cấp cho trợ lý AI quyền truy cập trực tiếp vào dữ liệu video dưới dạng ngữ cảnh có cấu trúc:

coniviso://videosDanh sách đầy đủ tất cả video có thể truy cập với metadata
coniviso://video/:idChi tiết video đầy đủ bao gồm phân tích và phiên mã
coniviso://video/:id/transcriptionDữ liệu phiên mã đầy đủ cho video cụ thể
coniviso://video/:id/analysisKết quả phân tích AI: tóm tắt, chương, cảnh, thực thể
coniviso://video/:id/permissionsDanh sách kiểm soát truy cập với quyền đã cấp
coniviso://organizationsDanh sách tất cả các tổ chức mà bạn tham gia
coniviso://organization/:idThông tin chi tiết tổ chức và danh sách thành viên
coniviso://organization/:id/groupsDanh sách tất cả các nhóm trong một tổ chức

Kết nối trong 30 giây

Thêm Coniviso vào client MCP bất kỳ với một khối cấu hình duy nhất. Sử dụng API key hiện có để xác thực.

Endpointhttps://www.coniviso.com/mcp

Xác thựcBearer vi_live_...

Giao vậnStreamable HTTP (JSON-RPC qua HTTP)

Mỗi phiên nhận được instance máy chủ riêng biệt. Phiên được xác định bởi header mcp-session-id.

mcp config

{
  "mcpServers": {
    "coniviso": {
      "url": "https://www.coniviso.com/mcp",
      "headers": {
        "Authorization": "Bearer vi_live_..."
      }
    }
  }
}

Bắt đầu

Sẵn sàng trong vài phút

1. Tạo API Key

Đi đến Cài đặt → API Key trong bảng điều khiển Coniviso. API key có định dạng vi_live_* và có thể cấu hình quyền chi tiết.

2. Xác thực yêu cầu

Đưa API key làm Bearer token trong header Authorization. Hoạt động cho cả REST API và kết nối MCP.

3. Bắt đầu xây dựng

Sử dụng REST API từ ngôn ngữ bất kỳ, hoặc kết nối máy chủ MCP với trợ lý AI. Cả hai chia sẻ cùng API key và quyền.

Quyền có sẵn

videos:readLiệt kê và đọc metadata video
videos:writeTải lên, cập nhật và xóa video
analysisGửi và đọc kết quả phân tích AI
searchTìm kiếm trong nội dung video
chatSử dụng tính năng chat AI (theo video và toàn thư viện)
embeddingsTạo và quản lý vector embedding

Sẵn sàng tích hợp?

Bắt đầu xây dựng với Coniviso API và máy chủ MCP. Gói miễn phí bao gồm 60 phút xử lý AI.

Lấy API Key của bạn Đọc tài liệu