Skill

뮤직비디오

업로드한 노래, 프롬프트, 참조 이미지를 Freebeat 뮤직비디오 작업으로 변환합니다.

freebeat CLI

지금 사용하기사전 설치됨

커뮤니티 총 사용량

4크레딧 사용량

8전체 생성 수

Skill 정보

skill.md

# 뮤직비디오

노래, 프롬프트, 선택적 참조 자료로 Freebeat 뮤직비디오를 생성할 때 사용합니다.

## 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 키를 붙여넣거나 로그로 남기지 마세요. 사용자가 터미널, 시크릿 저장소 또는 환경 변수로 제공하게 하세요.

## 자산 준비

~~~bash
freebeat assets upload-audio --file song.mp3
freebeat assets upload-audio --url https://www.youtube.com/watch?v=abc123
freebeat assets upload-image ref-a.jpg ref-b.jpg
~~~

## 업로드된 자산으로 MV 작업 제출

~~~bash
freebeat mv submit --music-id <musicId> --prompt "네온 도시, 빠른 컷" --image-url <imageUrl> --aspect-ratio 9:16 --wait
~~~

## 로컬 자산으로 MV 작업 실행

~~~bash
freebeat mv run --audio song.mp3 --image ref.png --prompt "네온 도시, 빠른 컷" --aspect-ratio 9:16 --wait
~~~

MV 명령은 --image-url, --image, --mv-type, --style, --aspect-ratio, --resolution, --watermark, --start-ms, --end-ms, --wait 등을 지원합니다.

## 진행 상황 확인

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을 사용하세요.