명령어 참조

Reela 명령어의 구문, 인수 및 옵션입니다. 설치된 버전의 도움말을 보려면 reela <command> -h를 실행하세요.

login / logout / whoami / status앵커 링크 복사

reela login
reela logout
reela whoami
reela status

• login는 브라우저 인증을 통해 로그인합니다. 표시된 URL을 열고, 요청되면 코드를 입력한 다음 명령어가 완료될 때까지 기다리세요.
• logout는 선택한 프로필에서 로그아웃합니다.
• whoami는 로그인된 계정을 표시합니다.
• status는 계정 및 전달 상태를 확인합니다.

reela --profile work login
reela --profile work whoami

create앵커 링크 복사

프롬프트와 선택적 미디어 파일을 사용해 동영상을 만듭니다.

reela create [PROMPT] --visual <TYPE> [OPTIONS]

위치 인수로 프롬프트를 제공하거나 --prompt-file를 사용하세요. --visual가 하나 이상 필요합니다.

시각 유형 및 파일 역할앵커 링크 복사

• ai-video: 샷을 생성합니다. 스타일을 지정하려면 선택적으로 reference-image:<path>를 첨부하세요.
• avatar: --avatar <id>로 선택한 발표자를 포함합니다.
• original-clip: 오디오 없이 영상을 편집합니다. video-source:<path>를 첨부하세요.
• original-sync: 영상의 오디오를 유지합니다. video-audio:<path>를 첨부하세요.
• image-video: 이미지를 애니메이션으로 만듭니다. original-image:<path>를 첨부하세요.

자신의 음악을 사용하려면 background-music:<path>를 사용하세요. 값을 쉼표로 연결하는 대신 플래그를 반복해서 지정하세요.

예시앵커 링크 복사

reela create "A product demo" --visual ai-video --layout portrait --dry-run
reela create --prompt-file brief.txt --visual image-video --file original-image:photo.png --dry-run

먼저 예상 크레딧을 확인하세요. 제출하려면 데몬을 시작하고 전달 구독을 설정한 뒤 --dry-run를 제거하세요. 제출 시 크레딧이 사용될 수 있습니다. Reela는 백그라운드에서 동영상을 생성하고 구독을 통해 완성된 결과물을 전달합니다. 아래의 데몬 / 구독 섹션을 참조하세요.

tasks앵커 링크 복사

작업을 나열하고 개별 작업 세부 정보 또는 출력 버전을 확인합니다. 장시간 실행되는 동영상 생성의 경우, 데몬 완료 구독을 사용하면 결과가 완성될 때 자동으로 받을 수 있습니다.

reela tasks list [--status <STATUS>] [--limit <N>] [--offset <N>] [--sort <ORDER>]
reela tasks get <TASK_ID>
reela tasks versions <TASK_ID> --origin brand [--limit <N>] [--offset <N>]
reela tasks download <TASK_ID> [--video <ID>] [--out-dir <DIR>]

• list: 기본적으로 결과 20개를 표시하며, 오프셋은 0이고 created_at:desc를 기준으로 정렬됩니다. 상태 필터: cancelled, pending, processing, failed, partial, completed.
• get: 작업 상태, 진행률 및 가능한 경우 생성 프롬프트를 표시합니다.
• versions: 완료되지 않은 출력도 포함해 브랜드 출력 버전을 나열합니다. --origin brand가 필요합니다. 제한: 1~100(기본값 20), 오프셋 기본값은 0입니다.
• download: 완성된 동영상을 설정된 디렉터리 또는 --out-dir로 다운로드합니다(짧은 형식: -o). 완료된 브랜드 출력을 선택하려면 --video를 사용하세요.

reela tasks list --status completed --output json

collection앵커 링크 복사

기존 컬렉션의 동영상을 제목 및 설명과 함께 나열합니다.

reela collection list [--session <TITLE>]
reela collection list --session "Product launch" --output json

REELA_COLLECTION_ID가 설정되어 있으면 이를 우선 사용합니다. 그렇지 않으면 선택한 프로필의 세션을 조회합니다. 기본 세션 reela-YYYY-MM-DD는 마지막으로 사용한 세션이 아니라 현지 날짜를 사용합니다. 이 명령어는 컬렉션을 만들지 않습니다. 컬렉션을 시작하려면 create를 사용하세요.

완성된 동영상에는 다운로드 URL이 포함될 수 있습니다. 이 링크는 민감한 정보로 취급하고 공개하지 마세요. 모든 링크에 인증이 필요하거나 만료 기간이 동일하다고 가정하지 마세요.

avatar앵커 링크 복사

reela avatar list
reela avatar get <ID>

avatar list는 사용 가능한 아바타를 나열하고, avatar get는 아바타 세부 정보를 표시합니다. 해당 ID를 create --avatar와 함께 사용하세요.

tiers앵커 링크 복사

선택한 프로필의 생성 옵션과 기본 등급을 나열합니다.

reela tiers list
reela tiers list --output json
reela --profile work tiers list

일반 출력에는 각 등급의 따옴표로 묶인 레이블, 설명 및 기본값 표시가 포함됩니다. JSON 출력에는 다음이 포함됩니다.

• default_tier: 사용 가능한 경우 기본 등급 레이블입니다.
• tiers: 선택 항목 목록으로, 각 항목에는 label, content(설명) 및 is_default가 포함됩니다.

대소문자를 유지하고 공백이 있는 레이블은 따옴표로 묶어, create --tier로 정확한 레이블을 사용하세요. 등급 설명에는 사용 가능한 생성 옵션이 안내되어 있습니다. 요청을 검증하거나 제출할 때 계정 접근 권한을 확인합니다.

reela create "A product demo" --visual ai-video \
  --tier "<tier-label>" --dry-run --output json

tiers list에서 반환된 레이블로 <tier-label>를 바꾸세요. 미리보기는 작업을 만들지 않고 credits_cost 및 quota_after를 반환합니다. 동일한 옵션으로 제출하려면 --dry-run를 제거하세요.

--tier가 없으면 create는 CLI에서 사용할 수 있는 기본값을 사용합니다. 기본값을 사용할 수 없는 경우 tiers list로 새로 고치거나 --tier를 지정하세요. 등급을 나열할 때와 동영상을 만들 때 같은 프로필을 선택하세요.

brand앵커 링크 복사

기존 브랜드 패키지를 나열하고 적용합니다.

reela brand list [--limit <N>] [--offset <N>]
reela brand apply <BRAND_ID> --task <TASK_ID> [--inputs '<JSON>']

list는 기본적으로 결과 20개와 오프셋 0을 사용합니다. 제한은 1~100이어야 합니다. apply는 브랜드 패키지를 적용하고 완성된 동영상이 나올 때까지 최대 10분 동안 기다립니다.

브랜드 패키지에 필요한 값을 제공하려면 --inputs를 사용하세요. 문자열, 숫자 또는 불리언 값이 포함된 JSON 객체를 허용합니다. 배열, 중첩 객체 및 null은 지원되지 않습니다. 매개변수 이름은 패키지에서 정의합니다. 예를 들면 다음과 같습니다.

reela brand apply <BRAND_ID> --task <TASK_ID> \
  --inputs '{"AUTHOR_PROFILE_IMAGE_URL":"https://example.com/avatar.jpg","AUTHOR_NAME":"Alex"}'

필수 템플릿 값이 누락되면 렌더링 전에 요청이 거부됩니다. 다시 적용하기 전에 누락된 값을 제공하세요. 이 매개변수에 자격 증명이나 비밀 정보를 포함하지 마세요.

기다리는 중에 중단되더라도 작업이 계속될 수 있습니다. 다시 적용하기 전에 출력 버전을 확인하세요.

reela tasks versions <task-id> --origin brand
reela tasks download <task-id> --video <video-id>

edit앵커 링크 복사

Reela에서 편집을 계속하려면 편집 JSON을 내보내고, 제한 없이 로컬에서 편집하려면 독립형 Remotion 프로젝트를 내보내세요.

reela edit versions <TASK_ID>
reela edit export-json <TASK_ID> --file <PATH> [--version <N>]
reela edit export-remotion <TASK_ID> [--video <VIDEO_ID>] [--out-dir <DIR>]
reela edit validate <FILE>
reela edit save <FILE>
reela edit render <FILE>

• versions: 초안 및 렌더링 실패 버전을 포함해 편집 가능한 버전을 나열합니다.
• export-json: 최신 또는 선택한 편집 버전을 JSON으로 내보내 Reela에서 편집할 수 있게 합니다. 파일을 편집하고 유효성을 검사한 다음 save 또는 render를 사용하세요.
• export-remotion: 제한 없이 로컬에서 편집할 수 있도록 독립형 Remotion 프로젝트를 내보냅니다. --video가 없으면 현재 편집 내용을 내보냅니다. 동영상 버전을 선택하려면 --video를 사용하세요. --out-dir(짧은 형식: -o)는 상위 디렉터리가 아니라 프로젝트 디렉터리 자체를 지정합니다. 지정하지 않으면 설정된 다운로드 디렉터리에 프로젝트 폴더가 생성됩니다. 기존 대상은 그대로 두고 숫자 접미사를 추가합니다. JSON 출력에는 최종 디렉터리 path가 포함됩니다.
• validate: 내용을 업로드하지 않고 편집 JSON에 오류가 있는지 확인합니다. 로그인과 인터넷 연결이 필요합니다.
• save: 렌더링하지 않고 초안을 저장합니다. 반환된 미리보기 URL을 열어 검토하세요.
• render: 저장하고 렌더링이 완료될 때까지 기다립니다. 성공하면 렌더링된 출력이 저장된 후에만 작업 ID와 미리보기 URL을 반환합니다. 서비스는 최대 10분 동안 기다리고, CLI는 응답을 위해 10분 30초까지 기다립니다. 렌더링 실패가 확인되면 종료 코드 10으로 종료되고, 시간 초과 시에는 종료 코드 6으로 종료됩니다. 제출은 자동으로 재시도되지 않습니다. 대기 중에 중단하거나 시간이 초과되어도 렌더링은 취소되지 않습니다. 다시 렌더링하기 전에 reela edit versions <task-id>를 확인하세요.

reela edit export-json <task-id> --file edit.json
reela edit validate edit.json
reela edit save edit.json

Remotion 내보내기는 패키징이 완료될 때까지 기다린 뒤 프로젝트를 다운로드하고 압축을 풉니다. ZIP 파일은 보관하지 않습니다. 패키징에는 최대 10분이 걸릴 수 있습니다. 제출은 자동으로 재시도되지 않습니다. 대기 중에 중단하거나 시간이 초과되어도 백그라운드 패키징은 취소되지 않습니다. 내보낸 프로젝트는 Reela로 다시 가져올 수 없으며 validate, save 또는 render 명령어를 사용하지 않습니다.

show앵커 링크 복사

show.yaml, subjects.yaml 및 episodes/*.md가 포함된 Show 작업 공간을 다운로드하고 편집합니다.

reela show list [--limit <N>] [--offset <N>]
reela show download <SHOW_ID> [--out-dir <DIR>] [--force]
reela show validate
reela show update [--dry-run] [--yes]

list는 기본적으로 결과 20개와 오프셋 0을 사용합니다. 다운로드한 작업 공간 디렉터리에서 validate 및 update를 실행하세요. update --dry-run는 로컬 또는 원격에 쓰지 않고 미리보기하며, --yes는 대화형 확인 없이 제출합니다.

파괴적 옵션: download --force는 관련 없는 파일을 포함해 대상 디렉터리의 기존 파일을 모두 삭제합니다. update는 전체 로컬 작업 공간을 제출합니다. Episode 파일을 제거하면 원격에서도 삭제되며, 로컬의 편집 가능한 콘텐츠는 버전 확인이나 병합 없이 원격 콘텐츠를 덮어씁니다. 생성 중이거나 일시 중지된 Show는 업데이트할 수 없습니다.

reela show download <show-id> --out-dir ./my-show
cd my-show
reela show validate
reela show update --dry-run
reela show update

show subject앵커 링크 복사

reela show subject download (--all | --subject-id <ID>) [--history] [--force]
reela show subject replace-image <SUBJECT_ID> --file <PATH>
reela show subject regenerate <SUBJECT_ID> --prompt-file <PATH> --model <MODEL> [--reference-image-id <ID>] [--yes]

• download: 현재 작업 공간의 모든 Subject 또는 하나의 Subject에 대한 이미지를 다운로드합니다. --history는 과거 이미지를 포함하고, --force는 기존 이미지 파일을 덮어씁니다.
• replace-image: 정적 JPEG, PNG 또는 WebP 이미지(최대 20 MiB 및 40메가픽셀)를 업로드하며, 이미지 기록과 기존 동영상을 유지합니다.
• regenerate: 이미지 하나를 생성하고 최대 10분 동안 기다립니다. 프롬프트 파일은 UTF-8이어야 합니다. --reference-image-id는 현재 작업 공간의 이미지를 선택하고, --yes는 대화형 확인 없이 생성을 승인합니다.

Show 다운로드에는 이미지가 아니라 구조화된 파일이 포함됩니다. Subject 이미지는 별도로 다운로드하세요. 과거 이미지를 선택하려면 subjects.yaml에서 current_image_id를 편집한 다음 업데이트하세요.

이미지 생성 중단은 대기만 중지하며 백그라운드 생성은 중지하지 않습니다. 명령어를 다시 실행하면 이미지가 다시 생성되고 요금이 부과될 수 있습니다.

config앵커 링크 복사

설정과 계정 프로필을 관리합니다.

reela config list
reela config get <KEY>
reela config set <KEY> <VALUE>
reela config profiles list
reela config profiles create <NAME>
reela config profiles show [NAME]
reela config profiles use <NAME>
reela config profiles delete <NAME>

설정은 선택한 프로필에 적용됩니다. 키와 현재 값을 확인하려면 config list를 사용하세요. profiles use는 기본 프로필을 변경하고, --profile는 단일 명령어에 사용할 프로필을 선택합니다.

reela config set delivery.download ~/Videos/reela
reela config profiles create work
reela --profile work login
reela config profiles use work

daemon / subscribe앵커 링크 복사

Linux 및 macOS에서 로컬 자동 전달을 관리합니다. 이 명령어는 Windows에서 사용할 수 없습니다.

reela daemon start [--foreground] [--keep-backlog]
reela daemon stop
reela daemon status
reela daemon install
reela daemon uninstall
reela daemon logs [--tail <N>]

• start: 자동 전달을 시작합니다. --foreground는 터미널에 연결된 상태로 유지합니다. 이 프로필에 저장된 전달 진행 상황이 없으면 --keep-backlog는 자동 전달이 가능한 이전 완료 동영상도 전달합니다. 그렇지 않으면 저장된 진행 상황부터 전달을 재개합니다.
• stop는 전달을 중지하고, status는 현재 상태를 표시합니다.
• install는 로그인 시 시작하도록 설정하고, uninstall는 자동 시작을 비활성화합니다.
• logs는 최근 로그를 표시하고, --tail는 기본적으로 20줄을 표시합니다.

subscribe앵커 링크 복사

reela subscribe list
reela subscribe status
reela subscribe add download [--dir <DIR>]
reela subscribe add email [--address <EMAIL>]
reela subscribe add script --path <PATH> [--timeout-seconds <N>] [--max-retries <N>]
reela subscribe remove <METHOD>

방식은 download, email 또는 script입니다. 이메일은 기본적으로 계정 이메일을 사용합니다. 스크립트는 신뢰할 수 있는 실행 파일이어야 하며, stdin에서 JSON 객체 하나를 읽고 성공 시 0으로 종료해야 합니다. --max-retries는 전체 전달 시도 횟수의 최댓값입니다. 스크립트 페이로드에는 reela subscribe add -h를 사용하세요.

방식을 추가하면 중지된 데몬을 시작하려고 시도합니다. 전달 설정을 변경한 후 이미 실행 중인 데몬이 변경 사항을 적용하도록 다시 시작하세요. 수동으로 시작한 데몬은 reela daemon stop를 실행한 뒤 reela daemon start를 실행하고, 서비스 관리자가 시작한 데몬은 서비스 관리자를 통해 다시 시작하세요.

reela subscribe add download --dir ~/Videos/reela
reela subscribe status

update앵커 링크 복사

설치된 CLI를 업데이트하고 버전을 확인합니다.

reela update
reela --version