메인 콘텐츠로 건너뛰기
POST
/
runwayml
/
v1
/
video_to_video
Generate a video from a video
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"
  }
}
'
{}
이 엔드포인트를 사용하면 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).

ratio
string
기본값:1280:720
필수

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

contentModeration
object
필수

응답

200 - application/json

success

The response is of type object.