runwayml-image-to-video의 기술 사양
| 사양 | 세부 정보 |
|---|---|
| 모델 ID | runwayml-image-to-video |
| 제공자 | Runway |
| 기본 기능 | 텍스트 프롬프트와 이미지 조건부 모션 생성을 사용하여 시작 이미지에서 비디오를 생성합니다. |
| API 작업 유형 | Runway의 image-to-video 엔드포인트를 통해 시작되는 비동기 이미지-투-비디오 생성 작업. |
| Runway API에서 지원되는 기반 모델 | Runway의 image-to-video 엔드포인트는 gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast, veo3 등 여러 비디오 모델을 허용합니다. |
| 필수 입력 | 입력 이미지와 모델별 생성 매개변수; 프롬프트 텍스트는 원하는 움직임과 장면 동작을 설명하는 데 일반적으로 사용됩니다. |
| 인증 | Authorization 헤더의 Bearer API 키. |
| 버전 지정 헤더 | Runway API 레퍼런스는 X-Runway-Version 헤더를 요구하며, image-to-video 엔드포인트의 문서화된 값은 2024-11-06입니다. |
| 출력 형식 | 작업 기반 API 처리를 통해 생성된 비디오 에셋이 반환됩니다. |
| 일반적인 프레임 레이트 | Runway 문서는 Gen-3 Alpha image-to-video 출력에 대해 24 fps를 명시합니다. |
| 일반적인 출력 해상도 | Runway는 Gen-3 Alpha의 경우 1280×768, Gen-3 Alpha Turbo의 경우 방향에 따라 1280×768 및 768×1280을 문서화하고 있습니다. |
| 이미지 입력 가이드라인 | Runway는 이미지 입력용 참조 이미지가 640×640 px보다 작거나 4K보다 큰 경우를 피할 것을 권장합니다. |
| CometAPI에서의 사용 패턴 | 플랫폼 모델 식별자 runwayml-image-to-video를 사용해 CometAPI를 통해 액세스합니다. |
runwayml-image-to-video란 무엇인가요?
runwayml-image-to-video는 Runway의 이미지-투-비디오 생성 기능에 접근하기 위한 CometAPI의 모델 식별자입니다. 실제로 이 범주의 모델은 정지 이미지를 시각적 출발점으로 삼아, 움직임, 카메라 동작, 분위기, 장면 전개 등을 설명하는 프롬프트 텍스트의 안내에 따라 생성된 비디오로 변환합니다.
Runway는 이미지-투-비디오를 더 넓은 비디오 생성 스택의 일부로 위치시킵니다. Gen-3 Alpha에 대한 문서에서는 이미지-투-비디오를 제공된 이미지를 애니메이션화하는 방식으로 설명하며, 프롬프트는 프레임에 이미 보이는 모든 것을 다시 설명하기보다는 특히 움직임에 초점을 맞추도록 안내합니다.
API 관점에서 Runway는 이미지-투-비디오 생성을 작업 생성 엔드포인트로 제공합니다. 이는 요청이 일반적으로 먼저 작업을 시작하고, 처리 완료 후 최종 비디오 결과를 얻기 위해 폴링 또는 결과 조회 단계를 필요로 함을 의미합니다.
runwayml-image-to-video의 주요 기능
- 이미지 조건부 비디오 생성: 정지 이미지에서 시작하여 텍스트만으로 비디오를 생성하는 것이 아니라 움직임 중심의 비디오 출력을 생성합니다.
- 프롬프트 기반 모션 제어: 프롬프트가 움직임, 카메라 동작, 장면 변화를 설명할 때 가장 잘 작동하여 제공된 프레임을 일관되게 애니메이션화합니다.
- 비동기 작업 워크플로: 생성 시작 요청 후 결과 조회가 이어지는 방식으로, 장시간 미디어 작업을 큐잉하고 모니터링하는 프로덕션 시스템에 적합합니다.
- 다중 기반 모델 옵션: Runway의 image-to-video API 엔드포인트는 여러 백엔드 비디오 모델을 지원하여 품질, 속도, 비용 프로파일에 대한 유연성을 제공합니다.
- 프로덕션급 API 인증: 표준 Bearer 토큰 인증과 명시적 API 버전 헤더를 사용하여 통제된 통합을 지원합니다.
- 가로/세로 출력 지원: 지원되는 모델 계열에서 가로 및 세로 생성 모드의 출력 크기를 문서화하고 있습니다.
- 참조 이미지 워크플로 호환성: API가 이미지 참조를 중심으로 설계되었으며, Runway는 생성 품질 유지를 위한 입력 크기 권장 사항을 제공합니다.
- 확장 가능한 크리에이티브 파이프라인 적합성: 키프레임, 확장 등 관련 비디오 생성 워크플로를 포함한 Runway 플랫폼과 연계되어, 이미지-투-비디오는 더 큰 크리에이티브 파이프라인의 한 단계로 유용합니다.
runwayml-image-to-video에 액세스하고 통합하는 방법
1단계: API 키 가입 및 발급
시작하려면 CometAPI에 가입한 후 대시보드에서 API 키를 발급받으세요. API 키를 받은 후에는 안전하게 보관하고 모든 요청의 Authorization 헤더에 사용합니다.
2단계: runwayml-image-to-video API로 요청 보내기
CometAPI를 통해 Runway의 공식 API 형식을 사용하세요. 엔드포인트는 POST /runwayml/v1/image_to_video입니다. X-Runway-Version 헤더를 포함합니다.
curl https://api.cometapi.com/runwayml/v1/image_to_video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "X-Runway-Version: 2024-11-06" \
-d '{
"model": "gen4_aleph",
"promptText": "Your prompt here."
}'
3단계: 결과 조회 및 확인
API는 작업 ID가 포함된 작업 객체를 반환합니다. 생성 상태를 확인하기 위해 GET /runwayml/v1/tasks/{task_id}를 폴링한 뒤, 완료된 작업 응답에서 출력 URL을 조회하세요.