TL;DR

CapCut không có API thật sự - bạn không thể lập trình để tạo video, add text, hay export MP4 theo chương trình. VectCutAPI lấp khoảng trống đó bằng cách wrap CapCut/Jianying engine qua REST HTTP và MCP (Model Context Protocol), cho phép AI agent điều khiển toàn bộ quá trình biên tập video. Apache-2.0 license.

Vấn đề cần giải quyết

CapCut chính thức không có lập trình API đầy đủ. Bạn không thể programmatically:

  • Tạo video mới từ template

  • Add scenes, text overlay, subtitle theo chương trình

  • Render ra MP4 qua API call

  • Tích hợp vào AI agent workflow

Bối cảnh thêm quan trọng: CapCut bị ban tại Mỹ từ tháng 1/2025 vì lo ngại an ninh dữ liệu liên quan ByteDance, khiến nhu cầu tìm alternative API tăng mạnh trong cộng đồng developer.

VectCutAPI ra đời để giải quyết đúng bài toán này - không phải thay thế CapCut app, mà mở khóa engine của nó cho code.

Hoạt động thế nào

Project chạy local trên máy của bạn, kết nối trực tiếp với CapCut hoặc Jianying (bản International). Có hai chế độ hoạt động song song:

  • HTTP REST API (port 9001) - gọi trực tiếp qua curl, Python requests, hoặc bất kỳ HTTP client nào

  • MCP Server (stdio) - tích hợp với AI agent qua Model Context Protocol: Claude Code, Coze, Dify, N8N

Output là CapCut draft folder (prefix dfd_) - bạn mở trong app để render ra video cuối cùng. Không có cloud render, không có SaaS - hoàn toàn self-hosted.

Setup chỉ 4 bước:

  1. Clone repo + tạo Python venv

  2. pip install -r requirements.txt

  3. Cài CapCut hoặc Jianying International + FFmpeg

  4. Chạy python capcut_server.py (HTTP) hoặc python mcp_server.py (MCP)

35+ endpoint - 11 MCP tool

Toàn bộ editing pipeline được wrap qua API:

MCP Tool

Chức năng

create_draft

Khởi tạo project mới (width, height)

add_video

Thêm video track với transitions & effects

add_text

Text có shadow, background, animation

add_audio

Layer audio, điều chỉnh volume, speed

add_subtitle

Import SRT, sync timing tự động

add_image

Ảnh với mask, filter, animation

add_effect

Visual effects từ thư viện CapCut

add_sticker

Sticker có animation và positioning

add_video_keyframe

Keyframe animation theo timeline

get_video_duration

Đọc thời lượng video

save_draft

Lưu project ra folder

Ngoài 11 MCP tool, bạn có thêm 35+ REST endpoint cho các thao tác chi tiết hơn.

VectCut Skill - kết hợp thẳng vào Claude Code

Project có sẵn VectCut Skill cho Claude Code trong thư mục vectcut-skill/. Sau khi cài, bạn có thể ra lệnh bằng ngôn ngữ tự nhiên và Claude sẽ tự gọi đúng API:

"Tạo video product showcase 1080x1920, thêm text 'Ra mắt sản phẩm mới' font 48px, background trắng, thêm nhạc nền, export draft."

Skill hỗ trợ 8 workflow template có sẵn: Text-to-Video, Video Mashup, Subtitle Integration, Keyframe Animation, Product Showcase, Split Screen, Image Slideshow, và Batch AIGC production.

So sánh với alternative

Không có tool nào hoàn toàn tương đương với VectCutAPI trong niche này:

  • JSON2Video: cloud API render MP4 trực tiếp, không cần CapCut, nhưng không có MCP/agent support, có phí theo usage

  • Remotion: code-based video bằng React/Node, hoàn toàn khác paradigm, không dùng CapCut ecosystem

  • Descript: text-based editing, không phải API-first

  • CapCut chính thức: chỉ có API cho background removal và image upscaling, không có full video creation API

Điểm độc đáo của VectCutAPI: MCP-native + CapCut draft format + open-source Apache-2.0 + agent workflow-ready.

Duy nhất trong phân khúc này.

Hạn chế cần biết

  • Phải cài CapCut/Jianying trên máy local - không phải pure cloud service

  • Output là draft folder, không render MP4 trực tiếp qua API - phải mở app để export

  • Self-hosted: không có hosted SaaS, bạn tự quản lý server

  • FFmpeg required

  • Python 3.10+ required

Nhưng đối với developer cần tích hợp vào AI agent workflow và không muốn phụ thuộc cloud vendor, đây đều là đánh đổi chấp nhận được.

Ai nên thử ngay

  • Developer build workflow video tự động với N8N, Dify, Coze

  • Claude Code users muốn AI agent tạo video từ nội dung có sẵn

  • Content creator cần batch production - tạo nhiều video cùng template khác data

  • Agency cần script hóa quy trình edit CapCut hiện tại

Tiếp theo và roadmap

Dự án đang tìm collaborators để phát triển tính năng batch AIGC video production - tự động hóa toàn bộ pipeline từ AI content generation đến video output.

Dev cycle hiện tại: PR vào dev branch, merge vào main mỗi thứ Hai. 5 release chỉ trong 7 tuần (tháng 8-9/2025) cho thấy tốc độ phát triển khá nhanh.