YouTube 영상을 등록하고 분석 파이프라인을 실행한다. stages 를 주면 일부 단계만 재실행한다.

작업 상태, 청크 진행도, 산출물 존재 여부, 로컬 Gemini 사용량 추정을 조회한다.

영상 개요와 timestamp 목차를 조회한다. needs_titles가 있으면 근거를 보고 제목을 직접 지은 뒤 cueprecise_set_chapter_titles를 호출한다.

영상 내용을 질의한다. 근거 span 과 frame 을 timestamp 와 함께 반환한다. 근거가 없으면 없다고 답한다.

사용자가 전체 영상 요약을 요청할 때만 요약을 만들거나 현재 요약을 재사용한다. 로컬 요약은 즉시 사용 가능하며, packet이 있으면 호스트가 cueprecise_set_summary로 한 번 개선할 수 있다.

cueprecise_summary packet만 근거로 작성한 구조화 요약을 검증·저장한다. chapter 경계와 timestamp는 서버가 결정한다.

cueprecise_outline의 needs_titles에 대해 호스트가 직접 지은 제목을 검증 후 저장한다. 경계와 원문은 바꿀 수 없다.

지정한 시각 구간의 자막 원문과 그 구간의 프레임을 조회한다. 긴 구간은 앞부분만 돌아오고 truncated 가 참이 된다 — 그때는 start 를 옮겨 이어 부른다.

화면 참조 시각의 프레임을 추출하고 frames.json 을 갱신한다. 영상이 없거나 --skip-video를 사용한 경우 원본 URL로 저해상도 영상을 받아온다. Gemini 호출 없음.

영상 자료를 명시적으로 삭제한다. scope: derived(기본) | chunks | video | raw | all. chunks 는 전사용 청크 오디오만 지우며 원본 오디오에서 다시 만들 수 있다.