비디오에서 비디오 생성

CometAPI Runway POST /runwayml/v1/video_to_video를 사용해 video-to-video 생성 작업을 시작하고, X-Runway-Version을 설정하며, 소스 클립을 변환합니다.

POST /runwayml/v1/video_to_video

Generate a video from a video

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/video_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "videoUri": "https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
  "promptText": "string",
  "seed": 4294967295,
  "model": "gen4_aleph",
  "references": [
    {
      "type": "image",
      "uri": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg"
    }
  ],
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}
'

200

{}

이 엔드포인트를 사용하면 Runway의 video-to-video 워크플로로 기존 소스 클립을 변환할 수 있습니다. 최종 결과를 즉시 반환하는 대신 비동기 작업을 시작합니다.

​

호출하기 전에

• 공급자의 입력 요구사항에 맞는 소스 비디오를 준비하세요
• 원하는 기능 세트에 맞는 필수 X-Runway-Version 헤더를 포함하세요
• 전체 스토리보드가 아니라 변경 내용을 설명하는 짧은 프롬프트(Prompt) 하나로 시작하세요

​

작업 흐름

1. 소스 클립과 프롬프트 제출

   이 엔드포인트에서 작업을 시작하고 반환된 작업 id를 저장하세요.

2. 작업 세부 정보 폴링

   작업이 종료 상태에 도달할 때까지 Runway to Get Task Details를 사용하세요.

3. 변환된 결과 저장

   일반적인 미디어 파이프라인을 통해 완료된 에셋을 다운로드하거나 저장하세요.

​

CometAPI 래퍼 참고

CometAPI는 Runway의 비동기 작업 모델과 버전별 요청 동작은 유지하면서, 플랫폼의 다른 부분과 인증 및 기본 URL 처리를 통합합니다.

인증

Authorization · string · header · 필수

Bearer token authentication. Use your CometAPI key.

헤더

X-Runway-Version · string · 필수

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

본문

application/json

videoUri · string · 기본값: https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4 · 필수

HTTPS URL of the source video, or a base64 data URI containing the video.

promptText · string · 기본값: A cat yawning in slow motion. · 필수

Text prompt describing the desired output. Maximum 1000 characters.

seed · integer · 기본값: 1 · 필수

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

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

Model variant to use.

references · object[] · 필수

Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).

Show child attributes

ratio · string · 기본값: 1280:720 · 필수

Aspect ratio of the output video, e.g. 1280:720.

contentModeration · object · 필수

Show child attributes

응답

200 - application/json

success

The response is of type object.