비디오 단편 스킬
단편(≤ 10초)은 현재 텍스트-투-비디오 모델에 가장 적합한 영역입니다. 이 모델들은 하나의 샷에 하나의 아이디어를 담는 데 뛰어나며, 여러 컷으로 구성된 내러티브에는 약합니다. 호출당 하나의 샷을 계획하세요.
특별한 경우: hyperframes-html은 사실적인 텍스트-투-비디오 모델이 아닙니다.
로컬 HTML-to-MP4 렌더러입니다. 이 모델의 경우, 영화 촬영 기법이나 "실제 세계"의 카메라 물리를
역할극하지 마세요. 브리프를 모션 디자인 카드 / 타이틀 프레임 / 제품 인터스티셜로 취급하고,
최대 하나의 명확한 질문을 한 후 즉시 실행하세요.
리소스 맵
video-shortform/
├── SKILL.md
└── example.html
작업 흐름
단계 0 — 프로젝트 메타데이터 읽기
videoModel, videoLength (초), videoAspect. 이 값들은
고정값입니다 — 선택한 모델이 지원하는 범위에 맞게 프롬프트를 조정하세요.
(Seedance 2는 최대 10초; Kling 4는 최대 10초 + 이미지-투-비디오 지원;
Veo 3는 8초, 오디오 지원).
단계 1 — 샷 계획
모델을 호출하기 전에 샷리스트를 작성하세요:
| 항목 | 내용 |
|---|---|
| 피사체 | 프레임 안에 무엇이 있는가? |
| 카메라 | 고정 / 팬 / 푸시인 / 궤도? |
| 조명 | 키 방향 + 색온도 |
| 모션 | 무엇이 움직이며, 속도는? 피사체 움직임 vs 카메라 움직임 |
| 사운드 | 앰비언트 배경음? (모델이 오디오를 지원하는 경우에만) |
일반적으로, 실행 전에 사용자에게 한 문장짜리 계획으로 보여주세요. 사용자가 저렴하게 방향을 수정할 수 있습니다.
hyperframes-html의 경우, 사용자가 발견 양식에 응답한 후에는
실행 전 추가 설명을 생략하세요. 계획을 실제 생성 프롬프트로 통합하고
즉시 실행하세요.
단계 2 — 프롬프트 구성
업스트림 모델이 선호하는 형식을 사용하세요.
(Seedance: 모션 + 카메라 + 분위기; Kling: 피사체 + 카메라 + 스타일;
Veo: 피사체 + 촬영 기법 + 사운드). 프로젝트의 videoAspect와 videoLength를
API 파라미터에 직접 바인딩하고, 절대 본문 텍스트에 넣지 마세요.
hyperframes-html의 경우, 카메라 현실감 프롬프트 대신 간결한
모션 디자인 브리프를 작성하세요. 피사체, 레이아웃, 팔레트, 모션 특성,
전반적인 톤에 집중하세요. 환경 확인, 누락된 사이드 파일, 또는
"지금 실행하려고 합니다" 상태 업데이트를 설명하는 데 시간을 낭비하지 마세요.
단계 3 — 미디어 계약을 통해 실행
통합 디스패처를 사용하세요 — 제공자 API를 직접 호출하지 마세요:
"$OD_NODE_BIN" "$OD_BIN" media generate \
--project "$OD_PROJECT_ID" \
--surface video \
--model "<메타데이터의 videoModel>" \
--aspect "<메타데이터의 videoAspect>" \
--length <videoLength 초> \
--output "<짧은-슬러그>-<초>s.mp4" \
--prompt "<단계 2에서 조합된 샷 프롬프트>"
명령어는 한 줄의 JSON을 출력합니다: {"file": {"name": "...", ...}}.
결과 파일은 프로젝트에 저장되며; FileViewer가 자동으로 재생합니다.
단계 4 — 전달
다음 내용으로 응답하세요: 샷 요약, 디스패처가 반환한 파일 이름, 그리고 사용자가 변형을 원할 경우 시도할 내용에 대한 한 문장.
hyperframes-html의 경우, 응답을 특히 짧게 유지하세요:
무엇이 렌더링되었는지, 파일 이름, 그리고 하나의 구체적인 변형 아이디어.
엄격한 규칙
- 한 번에 하나의 샷. 여러 샷의 타임라인은 하이퍼프레임스 / 인터랙티브 비디오 스킬에 속하며, 여기서 다루지 않습니다.
videoAspect를 정확히 일치시키세요 — 재렌더링은 느립니다.- 파일을 저장하지 않고 비디오를 제공하지 마세요 — 사용자는 파일 뷰어에서 재생할 무언가를 기대합니다.
- 기본 모델이 실패할 경우(NSFW 필터, 콘텐츠 정책, 타임아웃), 오류를 그대로 보고하세요. 조용히 재시도하지 마세요.
"$OD_NODE_BIN" "$OD_BIN" media generate를 실제로 호출하기 전에는 렌더가 "전송되었다", "시작되었다", 또는 "실행 중이다"고 주장하지 마세요.