Runway Gen-3 Alpha 설치 및 설정 가이드: 영상 편집자를 위한 완벽 온보딩
Runway Gen-3 Alpha 완벽 설정 가이드
Runway Gen-3 Alpha는 텍스트-투-비디오 생성, 모션 브러시, 카메라 컨트롤 등 혁신적인 AI 영상 제작 기능을 제공하는 플랫폼입니다. 이 가이드에서는 웹 앱 온보딩부터 API 연동 자동화 파이프라인 구축까지 전 과정을 단계별로 안내합니다.
1단계: 웹 앱 계정 생성 및 온보딩
- 공식 사이트 접속:
https://app.runwayml.com에 접속합니다.- 계정 생성: Google 계정 또는 이메일로 회원가입을 진행합니다.- 플랜 선택: Free 플랜(125크레딧/월)으로 시작하거나 Standard($12/월), Pro($28/월), Unlimited($76/월) 중 선택합니다.- 온보딩 완료: 첫 로그인 시 사용 목적(영상 편집, 광고 제작 등)을 선택하면 맞춤 대시보드가 구성됩니다.플랜 월 크레딧 최대 해상도 Gen-3 Alpha 접근 API 접근 Free 125 720p 제한적 불가 Standard 625 1080p 가능 불가 Pro 2,250 4K 전체 가능 Unlimited 무제한 4K 전체 우선 가능
2단계: 텍스트-투-비디오(Text-to-Video) 생성 설정
Gen-3 Alpha의 핵심 기능인 텍스트-투-비디오 생성 워크플로우를 설정합니다.
- 대시보드에서 Generate > Text to Video를 클릭합니다.- 모델을 Gen-3 Alpha로 선택합니다.- 프롬프트 입력 영역에 영상 설명을 작성합니다.- 아래 설정값을 조정합니다:
효과적인 프롬프트 작성 예시:설정 항목 권장값 설명 Duration 5s / 10s 생성 영상 길이 (5초 또는 10초) Aspect Ratio 16:9 일반 영상 편집에 적합한 비율 Resolution 1080p Pro 이상 플랜에서 사용 가능 Seed 고정 숫자 입력 동일 결과 재현 시 사용 A cinematic aerial shot of a coastal city at golden hour, camera slowly dollying forward over the ocean toward the skyline, warm sunlight reflecting on calm water, photorealistic, 4K quality
3단계: 모션 브러시(Motion Brush) 구성
모션 브러시를 사용하면 이미지의 특정 영역에 움직임을 지정할 수 있습니다. - **Generate > Image to Video**에서 소스 이미지를 업로드합니다.- 하단 도구 모음에서 **Motion Brush** 아이콘을 클릭합니다.- 움직임을 적용할 영역을 브러시로 칠합니다.- 방향 화살표를 드래그하여 **움직임 방향**과 **강도**를 설정합니다.- 배경에는 **Ambient** 모션을 추가하여 자연스러운 움직임을 부여합니다.
| 모션 브러시 파라미터 | 범위 | 용도 |
|---|---|---|
| Horizontal | -10 ~ +10 | 좌우 방향 움직임 |
| Vertical | -10 ~ +10 | 상하 방향 움직임 |
| Proximity | -10 ~ +10 | 카메라 접근/후퇴 효과 |
| Ambient | 0 ~ 10 | 미세한 자연스러운 흔들림 |
| 프리셋 | 동작 | 활용 장면 |
|---|---|---|
| Pan Left/Right | 수평 패닝 | 풍경, 인테리어 투어 |
| Tilt Up/Down | 수직 틸트 | 건물, 인물 전신샷 |
| Zoom In/Out | 줌 인/아웃 | 디테일 강조, 광각 전환 |
| Dolly Forward | 전진 달리 | 시네마틱 접근샷 |
| Orbit | 피사체 주위 회전 | 제품 촬영, 3D 효과 |
| Static | 고정 | 피사체 움직임만 강조 |
5단계: API 키 발급 및 자동화 파이프라인 연동
Pro 이상 플랜에서 API를 통해 영상 생성을 자동화할 수 있습니다.
API 키 발급
- 대시보드 좌측 하단 Settings > API Keys로 이동합니다.- Create API Key를 클릭하고 키 이름을 입력합니다.- 생성된 키를 안전하게 복사하여 환경변수에 저장합니다:
# 환경변수 설정 (Linux/macOS) export RUNWAY_API_KEY=“YOUR_API_KEY”
환경변수 설정 (Windows PowerShell)
$env:RUNWAY_API_KEY=“YOUR_API_KEY”
Python SDK 설치 및 기본 사용법
# SDK 설치
pip install runwayml
# 텍스트-투-비디오 생성 스크립트
from runwayml import RunwayML
client = RunwayML(api_key="YOUR_API_KEY")
task = client.image_to_video.create(
model="gen3a_turbo",
prompt_image="https://example.com/source-image.jpg",
prompt_text="A gentle breeze moves through the trees, cinematic lighting",
duration=10,
ratio="16:9"
)
print(f"Task ID: {task.id}")
print(f"Status: {task.status}")
생성 상태 폴링 및 다운로드
import time
task_id = task.id
while True:
status = client.tasks.retrieve(task_id)
if status.status == "SUCCEEDED":
print(f"영상 URL: {status.output[0]}")
break
elif status.status == "FAILED":
print(f"오류 발생: {status.failure}")
break
time.sleep(10) # 10초 간격 폴링
cURL을 이용한 직접 API 호출
curl -X POST "https://api.dev.runwayml.com/v1/image_to_video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gen3a_turbo",
"promptImage": "https://example.com/source.jpg",
"promptText": "Slow zoom into subject, warm lighting",
"duration": 10,
"ratio": "16:9"
}'
Pro Tips: 파워 유저를 위한 고급 팁
- Seed 고정 활용: 동일 시드 값으로 프롬프트만 미세 조정하면 일관된 스타일을 유지하면서 변형 영상을 만들 수 있습니다.- 프롬프트 구조화:
[주체] + [행동] + [환경] + [조명] + [카메라 워크] + [스타일]순서로 작성하면 품질이 크게 향상됩니다.- 배치 처리: API 연동 시 여러 프롬프트를 배열로 관리하고 비동기 태스크로 병렬 생성하면 대량 콘텐츠 제작이 가능합니다.- 모션 브러시 레이어링: 전경과 배경에 서로 다른 방향과 속도의 모션을 적용하면 깊이감 있는 영상을 만들 수 있습니다.- 크레딧 절약: Gen-3 Alpha Turbo 모델은 일반 모델 대비 빠르고 크레딧 소모가 적으므로 테스트 시 Turbo를 먼저 사용하세요.
Troubleshooting: 자주 발생하는 오류 해결
| 오류 메시지 | 원인 | 해결 방법 |
|---|---|---|
401 Unauthorized | API 키 만료 또는 오류 | Settings에서 새 API 키를 발급하고 환경변수를 업데이트하세요. |
CONTENT_MODERATION | 콘텐츠 정책 위반 프롬프트 | 프롬프트에서 제한 키워드를 제거하고 다시 시도하세요. |
Insufficient credits | 크레딧 부족 | 플랜 업그레이드 또는 크레딧 추가 구매를 진행하세요. |
| 영상 품질 저하 | 프롬프트가 모호하거나 해상도 설정 미흡 | 프롬프트를 구체적으로 작성하고 1080p 이상으로 설정하세요. |
Task timeout | 서버 부하 또는 긴 영상 생성 | 폴링 간격을 늘리고(30초), 피크 시간대를 피하세요. |
Q1: Runway Gen-3 Alpha는 무료로 사용할 수 있나요?
네, Free 플랜으로 월 125크레딧을 받아 기본적인 텍스트-투-비디오 생성을 체험할 수 있습니다. 다만 Gen-3 Alpha의 전체 기능(고해상도, 카메라 컨트롤, API 접근)을 사용하려면 Pro 이상 플랜이 필요합니다. 영상 편집 워크플로우에 본격적으로 활용하려면 Pro 플랜($28/월)을 권장합니다.
Q2: 모션 브러시와 카메라 컨트롤을 동시에 사용할 수 있나요?
현재 모션 브러시는 Image-to-Video 모드에서, 카메라 컨트롤은 Text-to-Video 및 Image-to-Video 모드에서 각각 사용 가능합니다. 두 기능을 결합하려면 먼저 모션 브러시로 피사체 움직임을 적용한 영상을 생성한 뒤, 후속 편집에서 카메라 무브먼트를 추가하는 2단계 워크플로우를 활용하세요.
Q3: API를 통해 생성한 영상의 저작권은 어떻게 되나요?
유료 플랜(Standard 이상) 사용자가 생성한 콘텐츠는 상업적 사용이 가능합니다. 단, Runway의 이용약관에 따라 콘텐츠 정책을 준수해야 하며, 생성된 영상에 대한 소유권은 사용자에게 귀속됩니다. 대규모 상업 프로젝트의 경우 Enterprise 플랜을 통해 추가적인 라이선스 보장을 받을 수 있습니다.