runway-video의 기술 사양
| 사양 | 세부 정보 |
|---|---|
| 모델 ID | runway-video |
| 제공사 | Runway |
| 모델 유형 | AI 비디오 생성 |
| 주요 모달리티 | 선택된 기본 Runway 모델에 따라 텍스트-투-비디오 및 이미지-투-비디오 |
| 입력 | 텍스트 프롬프트, 참조 이미지, 그리고 경우에 따라 업로드된 미디어 에셋 |
| 출력 | 생성된 비디오 클립 |
| API 패턴 | 비동기 태스크 기반 생성 워크플로 |
| 인증 | Bearer API 키 인증 |
| 필수 버전 헤더 | X-Runway-Version: 2024-11-06 |
| 기본 API 호스트 | api.dev.runwayml.com |
| 공식 SDK | Node.js 및 Python SDK 사용 가능 |
| 파일 처리 | 생성 요청에 사용할 runwayUri 값을 반환하는 임시 업로드 지원 |
| 요금 모델 | 크레딧 기반 과금; 이용 가능한 Runway 비디오 모델은 생성된 출력 1초당 과금 |
| 예시 하위 비디오 모델 | gen4.5, gen4_turbo, gen4_aleph, veo3, veo3.1, veo3.1_fast, gen3a_turbo |
runway-video란 무엇인가?
runway-video는 통합 API를 통해 Runway의 비디오 생성 기능에 접근하기 위한 CometAPI의 플랫폼 식별자입니다. Runway의 공식 API 문서에 따르면, Runway는 텍스트 프롬프트 또는 이미지로부터 클립을 생성할 수 있는 여러 비디오 모델을 제공하며, 생성을 시작하고 이후 결과를 가져오기 위한 태스크 기반 엔드포인트를 제공합니다.
실제로 runway-video는 단일 독립형 기반 모델명이 아니라 Runway 기반 비디오 제작 워크플로로 가는 게이트웨이로 이해하는 것이 가장 적절합니다. Runway의 현재 API 카탈로그에는 입력 모드와 가격 구간이 서로 다른 여러 비디오 모델이 포함되어 있으며, 예를 들어 텍스트 또는 이미지 기반 비디오 생성을 위한 gen4.5, 이미지-투-비디오용 gen4_turbo, 그리고 gen4_aleph, veo3, veo3.1, veo3.1_fast, gen3a_turbo 등의 추가 옵션이 있습니다.
이에 따라 runway-video는 크리에이티브 프로토타이핑, 마케팅 콘텐츠 생성, 소셜 미디어 클립 제작, 콘셉트 시각화, 자동화된 쇼트폼 비디오 합성이 필요한 제품 경험 등 다양한 용도에 적합합니다. 기본 Runway API가 비동기 작업을 사용하므로, 통합 시에는 보통 먼저 생성 요청을 제출한 뒤 처리 완료 시점까지 관련 엔드포인트를 폴링하거나 태스크 출력을 조회합니다.
runway-video의 주요 기능
- 텍스트-투-비디오 생성: Runway는 지원되는 모델에서 자연어 프롬프트로 비디오를 생성할 수 있도록 지원하여, 개발자가 설명적 텍스트만으로 클립을 바로 만들 수 있게 합니다.
- 이미지-투-비디오 워크플로: 여러 Runway 비디오 모델이 이미지 입력을 지원하므로,
runway-video는 정적 이미지를 애니메이션화하거나 참조 중심의 비디오 생성 파이프라인을 구축하는 데 유용합니다. - 다양한 하위 모델 옵션: Runway API는 역량과 비용 프로필이 다른 여러 비디오 모델을 제공하여, 품질·속도·예산에 맞춘 최적화를 유연하게 선택할 수 있게 합니다.
- 비동기 태스크 처리: 생성 요청은 최종 미디어를 즉시 반환하는 대신 태스크를 생성하므로, 큐잉, 재시도, 상태 확인이 필요한 프로덕션 시스템에 적합합니다.
- 임시 에셋 업로드: Runway는
runwayUri참조를 반환하는 업로드 엔드포인트를 제공하여, 이후 생성 요청에 이미지, 비디오, 오디오 에셋을 손쉽게 전달할 수 있게 합니다. - 공식 SDK 지원: Runway는 Node.js 및 Python SDK를 제공하며, 인증, 요청 구성, 출력 조회를 간소화할 수 있습니다.
- 버전 지정 API 통합: 요청에는 명시적인
X-Runway-Version헤더가 필요하여, 개발자가 명확한 API 계약에 맞춰 개발할 수 있도록 돕습니다. - 크레딧 기반 과금: Runway는 초당 크레딧으로 비디오 생성을 과금하며, 요금은 선택한 하위 모델에 따라 달라집니다.
runway-video에 접근하고 통합하는 방법
1단계: API 키 발급을 위한 가입
runway-video에 접근하려면 먼저 계정을 생성하고 CometAPI 대시보드에서 API 키를 발급받으세요. 로그인 후 API 키를 복사하여, 프로덕션에서는 환경 변수나 시크릿 매니저에 안전하게 보관하세요.
2단계: runway-video API로 요청 보내기
API 키를 사용해 runway-video용 CometAPI 엔드포인트에 대한 요청을 인증하세요. 요청 본문에 프롬프트와 지원되는 입력 파라미터를 전달하고, 모델을 runway-video로 지정합니다.
curl -X POST "https://api.cometapi.com/v1/responses" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "runway-video",
"input": "Create a cinematic video of a futuristic city at sunrise with slow camera movement."
}'
3단계: 결과 조회 및 검증
제출 후 API 응답에서 runway-video에 대해 반환된 생성 결과, 태스크 식별자 또는 결과 페이로드를 확인하세요. 생성이 비동기로 수행되는 경우 처리 완료까지 관련 CometAPI 엔드포인트를 폴링한 뒤, 애플리케이션에 사용하기 전에 반환된 비디오 URL, 메타데이터 및 콘텐츠를 검증하세요.