비디오 스튜디오

# 비디오 스튜디오

Freebeat CLI로 텍스트-비디오 생성을 할 때 사용합니다.

## CLI 명령을 실행하기 전에

Freebeat CLI는 npm 패키지이자 인증 API 클라이언트입니다. 먼저 설치하거나 업데이트하세요:

~~~bash
npm install -g freebeat-cli@latest
freebeat --help
~~~

생성 전에 Freebeat API 키가 필요합니다. 다음 방식 중 하나를 사용하세요:

~~~bash
freebeat auth set-api-key
printf '%s' "$FREEBEAT_API_KEY" | freebeat auth set-api-key --stdin
freebeat --api-key <apiKey> <command>
~~~

유료 또는 장시간 워크플로를 시작하기 전에 인증 정보를 확인하세요:

~~~bash
freebeat auth show
freebeat auth test
~~~

원본 API 키를 붙여넣거나 로그로 남기지 마세요. 사용자가 터미널, 시크릿 저장소 또는 환경 변수로 제공하게 하세요.

## 지원 비디오 모델

- Pixverse C1: --model pixverse-c1 or 103
- Pixverse V6: --model pixverse-v6 or 94
- Sora 2 Pro: --model sora-2-pro or 56
- Kling V3 4K: --model kling-v3-4k or 112
- SeedDance 2.0: --model seedance-2.0 or 102
- SeedDance 2.0 Fast: --model seedance-2.0-fast or 101
- Wan V2.7 Video: --model wan-v2.7-video or 104
- HappyHorse: --model happy-horse or 111

생성 전에 모델 확인:

~~~bash
freebeat models help --name pixverse-c1
~~~

## 비디오 생성

~~~bash
freebeat video generate --model pixverse-c1 --prompt "빠른 컷, 네온 도시, 역동적 카메라" --duration 5 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model pixverse-v6 --prompt "넓은 카메라 움직임의 드라마틱한 무대 공연" --duration 5 --resolution 720p --generate-audio --wait
freebeat video generate --model sora-2-pro --prompt "빛나는 음악 축제를 지나는 초현실적 야간 드라이브" --duration 8 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model kling-v3-4k --prompt "레이저 조명 아래 댄서가 있는 4K 뮤직비디오 장면" --duration 5 --resolution 4k --aspect-ratio 16:9 --wait
freebeat video generate --model seedance-2.0-fast --prompt "화려한 무대 조명의 빠른 댄스 몽타주" --duration 5 --resolution 720p --aspect-ratio 9:16 --wait
~~~

## 모델 제약

- Pixverse C1: duration 1-15, 360p|540p|720p|1080p, supports --generate-audio.
- Pixverse V6: duration 5-15, 720p|1080p, supports --generate-audio.
- Sora 2 Pro: duration 4|8|12, 720p|1080p, aspect ratio auto|16:9|9:16.
- Kling V3 4K: duration 3-15, resolution 4k.
- SeedDance models: duration 4-15, resolution 720p.
- Wan V2.7 Video: duration 2-15, 720p|1080p.
- HappyHorse: duration 3-15, 720p|1080p.

## 진행 상황 확인

Open RPC 이미지 및 비디오 명령은 batch id와 serial number를 반환합니다. 레거시 MV 및 효과 명령은 task id를 반환합니다.

~~~bash
freebeat task status <batch-id>
freebeat task status <batch-id> --serial-no <serial-no>
freebeat task wait <batch-id> --serial-no <serial-no>
freebeat task status <task-id>
freebeat task wait <task-id>
freebeat task result <task-id>
~~~

다른 Agent, 스크립트 또는 CI가 task id, batch id, serial number, 결과 URL, credits, status를 파싱해야 하면 --json을 사용하세요.