Skip to main content
POST
cURL
이 엔드포인트를 사용하면 하나의 소스 이미지를 애니메이션 처리하여 Runway 비디오로 만들 수 있습니다.

호출 전 확인 사항

  • 필수 X-Runway-Version 헤더를 전송하세요. 예: 2024-11-06
  • model: gen3a_turbo를 사용하세요
  • 안정적인 HTTPS promptImage를 제공하세요
  • duration: 5와 선택한 Runway model/version에서 지원되는 ratio 값으로 시작하세요

Duration 및 ratio

Runway 공식 형식 요청은 size가 아니라 ratio를 사용합니다. 해상도 스타일 ratio 값은 해당 WxH 값으로 이해하세요. 1280:7201280x720을, 720:1280720x1280을 의미하며, 1280:768도 선택한 model/version에 따라 여전히 1280x720으로 렌더링될 수 있습니다.

작업 흐름

1

이미지-투-비디오 요청 제출

소스 이미지와 선택 사항인 짧은 모션 프롬프트(Prompt)로 작업을 생성합니다.
2

반환된 id 저장

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

작업 상태 폴링

Runway 작업 가져오기를 사용하세요. 첫 번째 폴링에서 task_not_exist가 반환되면 몇 초 기다린 뒤 다시 시도하세요.

인증

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 an available 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. Runway support is model/version dependent; use 5 or 10 for the broadest compatibility. CometAPI forwards this value to Runway.

ratio
string
기본값:1280:768

Requested output ratio. Accepted values are Runway model/version dependent. With X-Runway-Version 2024-11-06, use a resolution-style value accepted by the selected model, such as 1280:768, 768:1280, 1280:720, or 720:1280. Read these as WxH targets, but completed media may normalize, so inspect the returned file before relying on exact pixels.

응답

200 - application/json

Task accepted.

id
string
필수