Web Subtitle Editor
자막 편집기 (Subtitle Editor)
AI 비디오 팩토리의 정밀 오디오 싱크 매핑과 실시간 무음 칩 탐지 및 원본 동기화 API 핵심 레퍼런스입니다.
자막 분석 CLI 명령어
python main.py analyze --video "/home/kang/coderoin/fast_ext/uploads/my_video.mp4" --lang ko
동영상 오디오를 Whisper AI 엔진으로 고속 분석하여, 한글/영어 정밀 자막 파일(`.json`, `.srt`)을 `/uploads` 디렉토리에 영상과 동일한 파일명으로 출력합니다.
자막 연동 REST API 명세
| METHOD | ENDPOINT | DESCRIPTION | PAYLOAD / RESPONSES |
|---|---|---|---|
| GET | /api/subtitle-editor/load | 서버 자막 파일 로드 및 비디오 매칭 | Query: `?path=/path/to/file.json` |
| POST | /api/subtitle-editor/upload-video | 작업용 원본 영상 파일 업로드 | Multipart/Form: `file` (Binary) |
| POST | /api/subtitle-editor/upload-subtitle | 기존 자막 파일(SRT, JSON) 서버 업로드 | Multipart/Form: `file` (Binary) |
| POST | /api/subtitle-editor/save | 실시간 무음 편집 변경사항 디스크 저장 | Body: `activeSegments` 배열 데이터 (JSON) |
| GET | /api/media/ | 서버 내 전체 미디어(영상) 리스트 조회 | Query: `?page=1&page_size=24` |
| POST | /api/media/{id}/process-factory | 특정 미디어 대상 AI 팩토리 파이프라인 즉시 실행 | Body: `{"project_id": "...", "params": {...}}` |
| GET | /api/subtitle-editor/check-adjacent | 동일 파일명 기준 자막 파일 실시간 매칭 체크 | Query: `?video_path=/path/to/video.mp4` |