logo
RunComfy
  • ComfyUI
  • 트레이너신규
  • 모델
  • API
  • 가격
discord logo
모델
탐색
모든 모델
라이브러리
생성 기록
모델 API
API 문서
API 키
계정
사용량

Kling 4.0 Video Editing: Models and API의 프롬프트 기반 영상 변경 | RunComfy

kling/kling-v4/video-edit

Kling 4.0 Video Editing는 720p 또는 1080p의 텍스트 명령에서 소스 클립을 다시 작성합니다.

목차

1. 시작하기2. 인증3. API 참조요청 제출요청 상태 확인결과 가져오기요청 취소4. 파일 입력호스트 파일(URL)5. 스키마입력 스키마출력 스키마

1. 시작하기

RunComfy API로 kling/kling-v4/video-edit을(를) 실행합니다. 허용되는 입력·출력은 모델 스키마.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-v4/video-edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "",
    "video_url": ""
  }'

2. 인증

환경 변수 YOUR_API_TOKEN 에 API 키를 설정하세요( 프로필에서 키 관리). 모든 요청에 Authorization 헤더로 Bearer 토큰을 포함: Authorization: Bearer $YOUR_API_TOKEN.

3. API 참조

요청 제출

비동기 생성 작업을 제출하면 즉시 request_id와 상태 확인·결과 조회·취소용 URL을 받습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-v4/video-edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "",
    "video_url": ""
  }'

요청 상태 확인

request_id의 현재 상태를 가져옵니다("in_queue", "in_progress", "completed", "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

결과 가져오기

지정한 request_id의 최종 출력과 메타데이터를 가져옵니다. 작업이 완료되지 않았으면 현재 상태가 반환되어 폴링을 계속할 수 있습니다.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

요청 취소

request_id로 대기 중인 작업을 취소합니다. 진행 중인 작업은 취소할 수 없습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 파일 입력

호스트 파일(URL)

공개적으로 접근 가능한 HTTPS URL을 제공하세요. 서버 측 페치가 가능하고(로그인/쿠키 불필요) 속도 제한이나 봇 차단이 없어야 합니다. 권장: 이미지 ≤ 50MB(약 4K), 동영상 ≤ 100MB(720p 기준 약 2–5분). 비공개 자산은 안정적이거나 사전 서명 URL을 권장합니다.

5. 스키마

입력 스키마

{
  "type": "object",
  "title": "입력 스키마",
  "required": [
    "prompt",
    "video_url"
  ],
  "properties": {
    "prompt": {
      "title": "프롬프트",
      "description": "변경 사항을 설명하세요. 소스 @Video1, 추가 비디오 @Video2, 이미지 @Image1 및 주제 @Element1를 호출합니다.",
      "type": "string",
      "examples": [
        "Edit @Video1. Change only the white teapot into a glossy cherry-red enamel teapot of the same shape. Keep the cup, the saucer, the table, the coat, the light, and the camera. Audio: quiet room tone, no music."
      ]
    },
    "video_url": {
      "title": "비디오 URL",
      "description": "편집할 소스 비디오, 3~30초. @Video1로 주소 지정됩니다. 더 긴 클립은 처음 30초로 제한됩니다.",
      "type": "string",
      "examples": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7480/media-files/promo-source.mp4"
      ]
    },
    "image_urls": {
      "title": "이미지 URL",
      "description": "선택적 참조 이미지(최대 10개)는 @Image1로 지정됩니다.",
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "string",
        "format": "image_uri"
      }
    },
    "video_urls": {
      "title": "비디오 URL",
      "description": "@Video2에서 처리되는 선택적 추가 비디오(최대 4개). 소스와 영상 주제를 합쳐서 30초로 계산됩니다.",
      "type": "array",
      "maxItems": 4,
      "items": {
        "type": "string",
        "format": "video_uri"
      }
    },
    "elements": {
      "title": "요소",
      "description": "최대 7개의 주제를 저장할 수 있습니다. 각각은 정면도와 선택적 각도 또는 3~8초짜리 단일 동영상입니다. 동영상은 최대 3개까지 가능합니다. @Element1, @Element2 등으로 참조하세요.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "frontal_image_url": {
            "type": "string",
            "format": "image_uri",
            "description": "대상의 정면 모습. 최대 3개의 추가 각도와 함께 사용하거나 대신 비디오를 사용하세요."
          },
          "reference_image_urls": {
            "type": "array",
            "format": "image_uris",
            "maxItems": 3,
            "items": {
              "type": "string",
              "format": "image_uri"
            },
            "description": "최대 3개의 추가 각도. 정면도가 필요하며 동영상과 결합할 수 없습니다."
          },
          "video_url": {
            "type": "string",
            "format": "video_uri",
            "description": "이미지 대신 사용되는 주제에 대한 3~8초 분량의 클립 1개. 최대 3개의 요소는 동영상일 수 있습니다."
          }
        }
      },
      "minItems": 0,
      "maxItems": 7
    },
    "duration": {
      "title": "길이",
      "description": "전체 초 단위의 출력 길이입니다. 이 항목을 비워두면 클립이 3~30초 동안 소스 비디오를 따릅니다.",
      "type": "integer",
      "minimum": 3,
      "maximum": 30
    },
    "resolution": {
      "title": "해상도",
      "description": "출력 해상도. 1080p가 기본값입니다. 720p는 더 가벼운 패스입니다.",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "1080p"
    }
  }
}

출력 스키마

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "단일 이미지 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "단일 동영상 URL"
      },
      "images": {
        "type": "array",
        "description": "여러 이미지 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "여러 동영상 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
팔로우하기
  • 링크드인
  • 페이스북
  • Instagram
  • 트위터
지원
  • 디스코드
  • 이메일
  • 시스템 상태
  • 제휴사
비디오 모델
  • HeyGen Video
  • MiniMax H3 Fast
  • Wan 3.0
  • Wan 2.6 Flash
  • Wan 2.5
  • MiniMax H3 Max
  • 모든 모델 보기 →
이미지 모델
  • HeyGen Image
  • Wan 2.6 Image to Image
  • Flux 2 Max Edit
  • Seedream 5.0 Pro
  • Nano Banana 2.1 Edit
  • Qwen Image Edit 2511 LoRA
  • 모든 모델 보기 →
법적 고지
  • 서비스 약관
  • 개인정보 보호정책
  • 쿠키 정책
RunComfy
저작권 2026 RunComfy. All Rights Reserved.

RunComfy는 최고의 ComfyUI 플랫폼으로서 ComfyUI 온라인 환경과 서비스를 제공하며 ComfyUI 워크플로우 멋진 비주얼을 제공합니다. RunComfy는 또한 제공합니다 AI Models, 예술가들이 최신 AI 도구를 활용하여 놀라운 예술을 창조할 수 있도록 지원합니다.