shorts-from-peaks
도구 순서
search_videos(query, n, shorts)- YouTube를 검색하고 결과를 조회수, 바이럴 가능성 기준으로 순위를 매겨 상위 피크와 함께 저장합니다.list_sources는 이미 저장된 소스를 보여줍니다. 공식 또는 허가된 소스를 우선하세요.get_peaks(video_id)- 저장된 소스의 히트맵 피크를 반환합니다. 히트맵이 없으면 그 사실을 알리고 다른 소스나 수동 윈도우를 제안하며, 피크를 절대 임의로 생성하지 마세요.create_clip_project(video_id, peak_rank=1, hook_text)- 피크에서 편집기 초안을 만들거나, 수동 윈도우를 위해start/end초를 전달합니다(직접 실행).render_project(video_id, hook_text, custom_script)- 백그라운드에서 초안을 렌더링하며(직접 실행),get_job(job_id)로 진행 상황을 확인합니다.checks_failed는 실패한 변환 검사 목록을 반환합니다.- 실패한 검사를 수정한 후,
queue_add(project_id)로 큐에 추가할 것인지 사용자에게 확인을 요청합니다.ui_open("editor", video_id)는 사용자에게 편집 화면을 보여줍니다.
- 히트맵이 없거나 사용자가 소유한 긴 업로드/링크인 경우:
autoclip_source(url, length, max_clips, prompt, create_drafts)는 자막에서 최적의 순간을 찾아 순위가 매겨진 클립을 반환합니다(get_job으로 확인).create_drafts=true이면 편집기로 바로 전송됩니다.
피크 읽기
- 값은 0-1로 정규화됩니다. 피크는 0.8 이상의 지역 최대값이며, 10초 이내로 가까운 피크는 하나로 병합됩니다.
- 동영상 첫 5% 구간의 급증(인트로 아티팩트)은 무시합니다. 값 기준 상위 3개를 유지합니다.
- 각 피크를
시작-종료,peak_value,rank와 함께 동영상 제목 및 URL로 보고합니다.
컷 윈도우
- 총 길이 15-30초(최대 30초: 변환 게이트에서 초과 시 거부).
- 피크 전 3-5초부터 시작하여 시청자가 설정을 볼 수 있도록 하고, 피크 후 2-4초에 종료하여 여운을 남깁니다. 문장 또는 동작 경계에서 자릅니다.
- 동영상 길이를 초과하지 않도록 조정합니다. 타사 클립의 런타임 50% 이상을 사용하지 마세요. B-롤, 이미지, 데이터 카드로 보완하세요.
- Short당 하나의 순간만 포함합니다. 두 개의 피크는 동일한 스토리 비트에 속할 때만 허용됩니다.
후크 (처음 3초)
- 질문, stake 또는 놀라운 주장을 첫 프레임에서 내레이션하고, 큰 화면 헤드라인(최대 6단어)을 표시합니다.
- 제목, 설명 또는 자막에 있는 사실만 사용하며, 루머에는 "RUMOR" 레이블을 붙입니다.
- 내레이션: 문장 8단어 이하, 약 2.5단어/초 속도로 후크 -> 맥락 -> 피크에서의 보상 -> 짧은 CTA 순서로 진행합니다. 원본 오디오는 낮게 유지하거나 끄고, 내레이터가 주도합니다.
변환 검사 (5가지 모두 통과해야 함; docs/LEGAL.md 참조)
narration: 원본 내레이션이 존재해야 함.visual_layers: 최소 2개의 추가 레이어(텍스트, 이미지/스티커, B-롤, 데이터 카드)가 있어야 함.text_overlay: 화면에 후크 또는 텍스트가 표시되어야 함.duration: 30초 이하여야 함.source_credit: 모든 플랫폼 캡션에 출처가 표시되어야 함. 하나라도 실패하면 프로젝트를 수정하고 다시 렌더링하세요. 재렌더링은 이전 승인을 무효화합니다.
캡션 및 텍스트
- 단어별 캡션, 그룹당 2-4단어, 굵은 산세리프 폰트, 흰색 텍스트에 검은색 외곽선, 활성화된 단어는 강조 표시.
- 캡션은 하단 약 12% 및 측면 약 6% 영역(플랫폼 UI)을 피하여 배치하세요. 이모지는 채널 스타일에서 사용하는 경우에만 추가하세요.
제목, 캡션, 해시태그
- 제목/첫 줄 = 후크, 80자 이내. 한 문장의 맥락 설명.
- 3-5개의 해시태그: 1개는 틈새, 1-2개는 주제, 1개는 광범위. 금지되거나 오해의 소지가 있는 태그는 사용하지 마세요.
- 항상
출처: <채널> - <URL>을 포함하세요. - 템플릿:
references/clip-brief.md
AI 공개
합성 내레이션(TTS) 또는 AI 시각 자료는 승인 전에 게시물별 AI 공개 플래그와 함께 플랫폼 자체 AI 레이블을 업로드 시 요구합니다. 확인 카드에서 사용자에게 알리세요.
하지 말 것
- 원본 클립, 30초 초과 클립, 또는 내레이션이 없는 클립을 게시하지 마세요.
- 사용자가 차단 표시했거나 비공개/회원 전용/로그인 필요 소스를 사용하지 마세요.
- 사용자 확인 없이 큐에 추가, 예약 또는 삭제하지 마세요.