HyperFrames CLI
npm install -g hyperframes # 또는 npx 사용
명령어
init
npx hyperframes init <name> [--template blank|product|explainer|slideshow] [--fps 30] [--width 1920] [--height 1080]
lint
npx hyperframes lint [file] [--fix] [--strict] [--json]
검사 항목: 유효한 data-hf-* 속성, 시간 형식, 중복 클립, 누락된 지속 시간, 접근 불가능한 에셋, TTS 길이 제한.
preview
npx hyperframes preview [file] [--port 3000] [--open] [--scene <name>] [--time <t>]
스크러버, 씬 선택기 및 핫 리로드를 지원하는 실시간 개발 서버.
render
export HEYGEN_API_KEY=your_key
npx hyperframes render [file] [--out output.mp4] [--format mp4|webm|gif] [--quality 85] [--scene <name>]
doctor
npx hyperframes doctor
Node ≥ 18, API 키, 네트워크, 에셋 경로, 설정 파일 구문을 점검합니다.
hyperframes.config.json
{
"version": 1,
"entry": "index.html",
"output": "./output.mp4",
"canvas": { "width": 1920, "height": 1080, "fps": 30 },
"render": { "quality": 85, "format": "mp4" },
"tts": { "defaultVoice": "en-US-neural-f1", "speed": 1.0 },
"assets": { "baseUrl": "./assets" }
}
환경 변수
| 변수 | 설명 |
|---|---|
HEYGEN_API_KEY | 렌더링에 필요 |
HEYGEN_REGION | us (기본값) 또는 eu |
HF_LOG_LEVEL | debug, info, warn, error |
개발 루프
npx hyperframes init my-video --template product
cd my-video
# index.html 편집
npx hyperframes lint
npx hyperframes preview --open
npx hyperframes render --out output.mp4