TL;DR

CapCut Mate는 FastAPI 기반의 오픈소스 Jianying 드래프트 자동화 API로서 드래프트 생성·소재 추가·키프레임 제어·클라우드 렌더링까지 비디오 편집 전체 파이프라인을 RESTful 엔드포인트로 제공합니다. OpenAPI 스펙과 Coze 플러그인 연동, Docker-compose를 이용한 빠른 배포, 그리고 자동 생성되는 /docs 문서를 통해 대형 모델이나 자동화 툴과의 통합이 수월합니다. 스타 수(1542)와 포크(244)가 나타내는 관심도를 고려하면 자체 호스팅 기반의 편집 자동화 또는 LLM 연계 실험을 하고자 하는 팀에게 바로 시도해볼 만한 실용적인 출발점입니다.

핵심 포인트

• 이 저장소는 독립적으로 배포 가능한 FastAPI 기반의 서버형 도구로, CapCut(剪映/Jianying) 드래프트 편집 작업을 자동화하는 API를 제공합니다. Coze나 n8n 같은 워크플로 자동화 도구와 연동할 수 있도록 OpenAPI 스펙과 Coze 플러그인 지원을 제공하여 대형 모델과 연계한 자동 편집 파이프라인을 구성할 수 있습니다. 자체 배포와 Docker-compose 빠른 배포가 모두 문서화되어 있어 온프레미스 또는 클라우드 환경에 바로 배치할 수 있습니다.
• 핵심 기능은 드래프트 생성·조회·저장, 비디오·이미지·스티커·자막·효과·마스크 등의 소재 추가, 키프레임·텍스트 스타일·애니메이션 제어, 클라우드 렌더링을 통한 최종 비디오 생성 등 비디오 편집 전체 워크플로를 RESTful API로 제공합니다. API 입력은 Pydantic 모델로 검증되며 FastAPI가 자동 생성하는 인터랙티브 문서(/docs, /redoc)를 통해 엔드포인트와 샘플 사용법을 즉시 확인할 수 있습니다. 이러한 구조는 LLM이나 자동화 엔진이 API를 호출하여 재현 가능한 편집을 수행하도록 설계되어 있습니다.
• 배포 방식은 로컬 Python 실행(uv run main.py)과 Docker-compose 기반의 빠른 배포 두 가지를 공식적으로 안내하며, macOS용 데스크톱 클라이언트(Jianying Assistant)와 함께 동작하는 사용 흐름도 제공됩니다. README에 macOS 설치 시 발생하는 서명 경고 해제 절차와 샌드박스 권한 설정 가이드가 포함되어 있어 데스크톱 연동 시 발생하는 실무 이슈를 줄일 수 있습니다. 또한 Coze 플러그인으로의 원클릭 임포트 절차와 OpenAPI(openapi.yaml) 업로드 방식이 이미지와 함께 문서화되어 있어 자동화 플랫폼과의 통합이 비교적 간단합니다.
• 기술 스택은 Python 3.11+, FastAPI, Pydantic, Uvicorn 기반이며 Passlib가 사용자 인증 시 암호화용으로 선택적으로 사용됩니다. OpenAPI/Swagger 규격으로 스펙을 제공하므로 외부 도구가 스펙을 읽어 클라이언트나 플러그인을 자동 생성할 수 있고, README에 curl 예제와 각 엔드포인트 별 상세 문서 링크가 포함되어 있습니다. 요구사항으로 Python 3.11 및 프로젝트 관리용 uv(astral.sh 기반) 사용이 명시되어 있으므로 운영 환경의 Python 버전과 패키지 관리 방식을 맞춰야 합니다.

이미지 분석