Runway 비디오 API 설정
Runway는 비디오 생성 플랫폼입니다. 일반적으로 Chatbox 등에 Base URL로 입력하는 방식이 아니며, Runway 플랫폼에서 API Key를 발급받은 후 공식 SDK나 HTTP 요청을 통해 비디오 생성 작업을 호출해야 합니다.
공식 정보 다운로드 및 문서는 공식 사이트를 기준으로 합니다.
주요 활용 분야
텍스트 투 비디오이미지 투 비디오비동기 작업공식 SDK
비디오 작업 흐름 먼저 이해하기
- API Key를 생성하고 계정에 비디오 API 권한 및 잔액이 있는지 확인합니다.
- 작업 유형을 선택합니다: 텍스트 투 비디오, 이미지 투 비디오 또는 공식 문서에서 현재 지원하는 기타 비디오 작업.
- 작업 제출 즉시 비디오 파일이 반환되지 않으며, 일반적으로 작업 객체나 task ID를 먼저 받게 됩니다.
- 작업이 완료될 때까지 기다린 후 결과물 주소를 읽거나 다운로드합니다.
- 실패 시 API Key만 확인하지 말고 작업 상태와 세부 오류 메시지를 먼저 확인하세요.
파라미터 준비
| 설정 항목 | 작성 방법 |
|---|---|
| API Key | Runway 콘솔에서 생성; 공식 SDK는 기본적으로 <code>RUNWAYML_API_SECRET</code>을(를) 읽음 |
| Task | text-to-video / image-to-video |
| Prompt | 비디오 내용 설명 |
| Ratio / Size | 가로, 세로 또는 지정된 해상도 비율 |
| Duration | 비디오 길이(초) |
| Status | 작업 완료 시까지 폴링(조회) |
| 설정 항목 | 설명 | 초보자를 위한 팁 |
|---|---|---|
| API Key | Runway API 요청 자격 증명 | RUNWAYML_API_SECRET 환경 변수명을 사용하여 로컬 PC 또는 서버의 환경 변수에만 저장하세요 |
| Prompt | 비디오 내용 설명 | 처음에는 짧게 작성하여 스타일을 확인한 뒤 점차 구체화하세요 |
| Image | 이미지 투 비디오의 시작 이미지 | 피사체가 뚜렷하고 선명한 고화질 이미지를 업로드하세요 |
| Duration | 비디오 길이(초 단위) | 비용과 생성 효과를 확인하기 위해 먼저 짧은 길이로 테스트하세요 |
| Status | 작업 상태 | 비디오 생성은 비동기 작업이므로 완료될 때까지 기다려야 합니다. |
SDK 예제
Runway 환경 변수명
RUNWAYML_API_SECRET=YOUR_RUNWAY_API_KEYRunway Node.js 작업 예제
import RunwayML, { TaskFailedError } from "@runwayml/sdk"; const client = new RunwayML(); try { const task = await client.imageToVideo.create({ model: "gen4.5", promptText: "A product introduction video on a white background with a slow camera push-in", ratio: "1280:720", duration: 5 }).waitForTaskOutput(); console.log(task.output[0]); } catch (error) { if (error instanceof TaskFailedError) { console.error(error.taskDetails); } }비디오 플랫폼의 파라미터 필드는 모델 버전에 따라 업데이트될 수 있습니다. 본 페이지의 예제는 설정 구조를 이해하기 위한 참고용이며, 실제 필드는 공식 문서의 최신 버전을 기준으로 작성해야 합니다.
| 현상 | 우선 확인 사항 | 해결 방법 |
|---|---|---|
| 제출 후 비디오가 즉시 반환되지 않음 | 작업이 대기열에 있거나 아직 생성 중인가요? | 비디오 생성은 비동기 작업입니다. 상태가 완료(complete)될 때까지 기다린 후 결과를 조회하세요. |
| 작업 실패 | 모델 이름, 비율, 재생 시간, 입력 이미지가 현재 모델의 요구 사항을 충족하는지 확인 | 반환된 오류 세부 정보를 기반으로 파라미터를 조정하며, 한 번에 너무 많은 항목을 수정하지 마세요. |
| 예상보다 많은 요금이 청구됨 | 재생 시간, 해상도, 모델 버전 | 짧은 재생 시간과 저비용 파라미터로 먼저 테스트한 후 대량 생성을 진행하세요. |