비디오 숏폼 스킬
숏폼(≤ 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를 호출하지 마세요:
node "$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 media generate를 호출하기 전에는 렌더링이 "전송되었음", "시작되었음", 또는 "실행 중"이라고 주장하지 마세요.