자동화
Reela CLI 완료 구독을 통해 동영상을 만들고 완성된 결과를 워크플로에 연결하세요.
Reela CLI 완료 구독을 통해 동영상을 만들고 완성된 결과를 워크플로에 연결하세요.
Reela는 동영상 제작 명령어와 완성된 동영상에 대한 완료 구독 기능을 제공합니다. 에이전트나 다른 도구가 브리프를 제출하고 CLI 데몬을 통해 결과물을 받을 수 있으므로 Reela 웹사이트를 계속 열어 둘 필요가 없습니다.
브리프에서 동영상까지
create는 텍스트 브리프와 선택적 미디어를 동영상 작업으로 변환합니다. 프롬프트를 직접 입력하거나 파일에서 읽어 오고, 길이와 레이아웃을 선택하고, 아바타를 포함하며, 참조 이미지, 영상 또는 배경 음악을 첨부할 수 있습니다.
reela create --prompt-file brief.txt \
--visual ai-video --layout portrait --duration 30 \
--session "Product campaign" --output json동영상 생성은 장시간 실행되는 작업입니다. 제출하기 전에 데몬을 시작하고 완료 구독을 설정하세요. Reela는 백그라운드에서 생성을 실행하고 완성된 결과를 스크립트에 전달합니다. 세션 제목을 재사용하면 관련 동영상이 하나의 프로젝트로 묶입니다. 설정 방법은 아래의 자동 전달를 참조하세요.
제출하기 전에 --dry-run를 추가하면 파일을 업로드하거나 작업을 생성하지 않고 요청을 검증하고 예상 크레딧을 미리 확인할 수 있습니다. 작업을 제출하면 크레딧이 사용될 수 있습니다.
지원되는 시각 자료와 미디어 입력은 동영상 제작 옵션을 참조하세요.
티어로 화질과 비용 선택하기
티어를 사용하면 각 요청의 생성 옵션을 선택할 수 있습니다. Reela는 본인이나 에이전트가 원하는 결과에 맞는 옵션을 선택하는 데 도움이 되는 설명을 제공하고, 제출 전에 해당 요청에 필요한 크레딧을 예상합니다.
reela tiers list
reela tiers list --output json목록에는 각 티어의 이름과 설명이 표시되며 기본 티어도 식별됩니다. JSON 출력에서 tiers에는 label, content, is_default가 포함되고, default_tier에는 기본 티어가 표시됩니다. 목록에서의 순서가 아니라 각 옵션을 이해하려면 content를 확인하세요. 티어를 나열해도 계정에서 모든 옵션을 사용할 수 있다는 보장은 없습니다. Reela는 요청을 검증하거나 제출할 때 액세스 권한을 확인합니다.
--tier에 정확한 이름을 전달하세요. 아래의 <tier-label>를 목록에 있는 이름으로 바꾸세요. 이름에 공백이 있으면 따옴표를 유지하세요:
reela create --prompt-file brief.txt --visual ai-video \
--tier "<tier-label>" --duration 30 --layout portrait \
--dry-run --output json미리 보기에는 credits_cost와 quota_after가 반환됩니다. 제출하려면 --dry-run를 제거하고 선택한 티어와 다른 옵션은 그대로 두세요. 티어는 생성 옵션을 나타내며, 실제 요청의 비용을 예상하려면 미리 보기를 사용하세요.
--tier를 생략하면 Reela는 CLI에서 현재 사용할 수 있는 기본 티어를 사용합니다. 기본 티어를 사용할 수 없다면 reela tiers list를 실행해 옵션을 새로고침하거나 티어를 직접 지정하세요. 티어를 직접 선택하면 기본값이 변경되어도 워크플로에서 선택한 옵션이 유지됩니다. 단, 사용 가능 여부와 가격은 여전히 변경될 수 있습니다. 목록 확인, 미리 보기, 제출 시 동일한 프로필을 사용하세요.
출력 세부 정보와 선택 동작은 티어 명령어 참조를 확인하세요.
에이전트와 도구를 위한 구조화된 결과
--output json를 사용하면 티어 선택, 크레딧 예상치, 제출 확인을 포함한 명령어 결과를 구조화된 데이터로 확인할 수 있습니다. 종료 코드 0는 명령어가 성공했음을 의미합니다. 오류에는 0이 아닌 종료 코드와 stderr의 일반 텍스트가 사용되며, JSON 모드에서도 동일합니다.
성공적으로 제출되면 데몬이 완료를 기다리고 구독된 스크립트를 결과와 함께 호출합니다. 제출 응답과 완료 이벤트에는 task_id가 포함되어 워크플로에서 완성된 동영상을 원래 브리프와 연결할 수 있습니다.
자동 전달
Reela CLI는 동영상 작업이 완료되면 사용자가 지정한 실행 파일을 실행할 수 있습니다. 완료 구독을 통해 Reela의 결과물을 다음 작업에 연결할 수 있습니다. 예를 들어 동영상을 게시 도구에 전달하거나, 레코드를 업데이트하거나, 다른 시스템에 알림을 보낼 수 있습니다. Reela는 완료 여부를 감지하고 작업 세부 정보를 스크립트에 전달합니다.
스크립트 등록
Reela CLI를 실행하는 컴퓨터에 있는 실행 파일의 절대 경로를 입력하세요. stdin에서 이벤트를 읽고 종료 코드로 성공 여부를 보고하기만 하면 어떤 언어로든 사용할 수 있습니다.
reela subscribe add script --path /absolute/path/on-video \
--timeout-seconds 300 --max-retries 3각 프로필에는 스크립트 구독 하나만 설정할 수 있습니다. 기존 구독의 실행 파일을 변경하려면 reela config set delivery.script.path /absolute/path/on-video를 사용하세요. 아래에 설명된 대로 구독이나 설정을 변경한 후에는 이미 실행 중인 데몬을 다시 시작하세요.
완료 이벤트 수신
Reela가 실행 파일을 시작하고 stdin에 JSON 객체 하나를 씁니다:
{
"event": "task.completed",
"task_id": "12345",
"status": "completed",
"status_label": "completed",
"title": "Product demo",
"description": "A short product introduction",
"download": {
"filename": "product-demo.mp4",
"download_url": "https://example.com/video.mp4"
}
}task_id를 사용해 이벤트를 원래 제출 건과 연결하세요. title, description, download는 null일 수 있습니다. download가 있으면 스크립트에서 바로 사용할 수 있도록 완성된 동영상의 권장 파일명과 다운로드 URL이 제공됩니다. 동영상이 필요한 작업을 실행하기 전에 download 값이 누락된 경우를 처리하세요.
서명된 download_url 링크는 생성 후 6시간이 지나면 만료됩니다. 완료 이벤트를 받은 후 즉시 동영상을 다운로드하거나 자체 저장소에 복사하세요. 다운로드 URL은 비공개로 유지하고 영구적인 동영상 주소가 아닌 임시 액세스 링크로 취급하세요.
구독은 CLI 외부에서 생성된 동영상을 포함해 선택한 계정의 완료된 작업을 수신합니다. 특정 워크플로에 해당하는 작업을 수행하려면 이벤트의 작업 ID를 제출한 작업과 대조하세요. 완료 구독은 현재 성공적으로 완료된 작업을 처리합니다. 실패, 취소 또는 부분 완료된 작업은 이 이벤트를 발생시키지 않습니다.
실행 및 재시도
- 성공: 작업이 성공하면
0로 종료하세요. Reela는 스크립트의 stdout을 버리며, 출력된 텍스트를 결과로 사용하지 않습니다. - 시간 초과:
--timeout-seconds 300는 각 실행에 최대 300초를 허용합니다. 시간 초과 또는 0이 아닌 종료 코드는 전달 실패로 처리됩니다. - 재시도: Reela는 전달 실패를 재시도합니다. 스크립트 방식만 실패한 경우
--max-retries 3는 최초 실행을 포함해 총 세 번의 시도를 허용합니다. 다른 활성화된 방식과 관련된 실패에는delivery.max_retries가 적용됩니다. - 중복 전달: 같은
task_id에 대해 작업을 반복해도 안전하도록 만드세요. 그래야 다시 실행되더라도 같은 동영상을 다시 게시하거나 같은 레코드를 두 번 추가하지 않습니다.
구독을 계속 실행하기
CLI 데몬은 완료 이벤트를 처리하고 활성화된 전달 방식을 실행합니다. 방식을 선택한 후 데몬을 시작하고 전달 상태를 확인하세요:
reela daemon start
reela subscribe status방식을 추가하면 중지된 데몬을 시작하는 작업도 시도됩니다. 데몬이 이미 실행 중이라면 전달 설정을 변경한 후 해당 설정을 적용하기 위해 데몬을 다시 시작하세요. 데몬을 수동으로 시작한 경우 reela daemon stop를 실행한 다음 reela daemon start를 실행하세요.
Reela는 전달 진행 상황을 저장하고 데몬이 다시 시작되면 그 지점부터 이어서 처리합니다. 저장된 진행 상황이 없으면 기본적으로 새 이벤트를 처리합니다. 저장된 진행 상황이 없을 때 reela daemon start --keep-backlog는 여전히 사용할 수 있는 이전 완료 작업 이벤트도 처리합니다.
로그인 시 자동 시작을 활성화하려면 reela daemon install를 사용하세요. 서비스로 설치된 경우 설정을 변경한 후 운영체제의 서비스 관리자를 통해 서비스를 다시 시작하세요. 전달 상태를 확인하려면 reela daemon status 또는 reela daemon logs --tail 50를 확인하세요.
자동 전달을 사용하려면 데몬을 실행하는 컴퓨터가 켜져 있고 네트워크에 연결된 상태를 유지해야 합니다. 스크립트가 동영상 완료 이벤트에 반응해야 한다면 동영상을 제출하기 전에 데몬을 시작하세요.
daemon 및 subscribe는 Linux와 macOS에서 사용할 수 있습니다. Windows x64에서는 동영상 명령어, 상태 조회, 수동 다운로드를 지원합니다.
선택적 다운로드 및 이메일 전달
스크립트와 함께 자동 다운로드 또는 완성된 동영상 이메일을 활성화할 수 있습니다. 기본 전달 설정에서는 다운로드가 활성화되어 있습니다. reela config set delivery.download ~/Videos/reela로 저장 위치를 지정하세요. 다운로드가 비활성화되어 있으면 reela subscribe add download --dir ~/Videos/reela로 활성화하세요. 이메일은 reela subscribe add email로 활성화하고, 계정 이메일이 아닌 다른 주소를 사용하려면 선택적으로 --address me@example.com를 추가하세요.
여러 방식을 동시에 활성화할 수 있으며, 한 방식의 실패가 다른 방식의 실행을 막지는 않습니다. 각 스크립트 실행에는 사용 가능한 경우 다운로드 정보가 포함된 자체 완료 페이로드가 전달됩니다. 모든 방식은 전달 명령어 참조를 확인하세요.
제작 설정 재사용
Reela는 워크플로 단계로 활용할 수 있는 추가 기능을 제공합니다:
- 일관된 브랜딩:
brand list로 기존 브랜드 패키지를 나열하고brand apply로 작업에 적용하세요. 이 명령어는 브랜드가 적용된 결과물이 나올 때까지 기다립니다. 브랜드 명령어를 참조하세요. - 프로그래밍 방식 편집: 편집 JSON을 다운로드하고, 변경 사항을 검증하고, 미리 보기를 위한 초안을 저장한 다음
edit로 렌더링을 제출하세요. 편집 명령어를 참조하세요. - 계정 및 환경설정 분리:
--profile또는REELA_PROFILE로 프로필을 선택하세요. 전달 방식과 설정은 선택한 프로필에 적용됩니다. 프로필 및 구성을 참조하세요.
예를 들어 제품 동영상 워크플로에서는 참조 이미지와 함께 브리프를 제출하고, 데몬 완료 구독을 사용해 완성된 동영상을 게시 도구에 전달할 수 있습니다. Reela는 백그라운드 생성과 완료 전달을 제공합니다. 제출 시점과 결과를 받은 후 수행할 작업은 사용자의 도구가 결정합니다.