이미지를 비디오로

CometAPI를 사용해 Runway image_to_video를 호출하고 정지 이미지 URL을 원시 비디오 출력으로 변환하며, 호환성을 위해 X-Runway-Version을 지원합니다.

POST /runwayml/v1/image_to_video

Create a Runway image-to-video task

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/image_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
  "model": "gen3a_turbo"
}
'

200

{
  "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}

이 엔드포인트를 사용하면 하나의 원본 이미지를 애니메이션 처리해 Runway 비디오로 만들 수 있습니다.

​

호출 전에 확인하세요

• 필수 X-Runway-Version 헤더를 전송하세요. 예: 2024-11-06
• model: gen3a_turbo를 사용하세요
• 안정적인 HTTPS promptImage를 제공하세요
• duration: 5와 1280:720 같은 일반적인 비율로 시작하세요

​

작업 흐름

1. 이미지-비디오 요청 제출

   원본 이미지와 선택 사항인 짧은 모션 프롬프트로 작업을 생성합니다.

2. 반환된 id 저장

   나중에 폴링할 수 있도록 작업 id를 저장합니다.

3. 작업 상태 폴링

   Get Task Details를 사용하세요. 첫 번째 폴링에서 task_not_exist가 반환되면 몇 초 기다린 뒤 다시 시도하세요.

2026-03-13에 수행한 실시간 검증에서 최소한의 gen3a_turbo 요청이 정상적으로 수락되어 id가 반환된 것이 확인되었습니다. 짧은 지연 후, 공식 task-details와 역방향 feed 모두 해당 작업에 대해 동일한 래핑된 대기열 상태를 반환했습니다.

인증

Authorization · string · header · 필수

Bearer token authentication. Use your CometAPI key.

헤더

X-Runway-Version · string · 필수

Runway version header, for example 2024-11-06.

본문

application/json

promptImage · string · 기본값: https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg · 필수

Source image URL.

model · string · 기본값: gen3a_turbo · 필수

Runway image-to-video model ID. Choose a current model from the Models page.

seed · integer

Random seed for reproducible results. Range: 0–999999999.

promptText · string

Text prompt describing the desired motion or scene. Maximum 512 characters.

watermark · boolean · 기본값: false

Whether to add a watermark to the output video.

duration · integer · 기본값: 5

Video duration in seconds. Accepted values: 5 or 10.

ratio · enum<string> · 기본값: 1280:720

Aspect ratio of the output video.

사용 가능한 옵션: 1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280

응답

200 - application/json

Task accepted.

id · string · 필수