Kling Kling V3.0 4K Image-to-Video API | 요금 및 문서

kling/kling-3.0/4k/image-to-video

필수 시작 이미지와 선택형 종료 이미지를 바탕으로 네이티브 4K 시네마틱 영상을 구현합니다. 다중 프롬프트 전환, 참조 요소 고정, 동기화 오디오를 지원합니다.

1. 시작하기

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
  }'

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-3.0/4k/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
  }'

요청 상태 확인

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",
    "start_image_url"
  ],
  "properties": {
    "prompt": {
      "title": "프롬프트",
      "description": "",
      "type": "string",
      "default": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science."
    },
    "multi_prompt": {
      "title": "다중 프롬프트 구간",
      "description": "장면 전환을 위한 여러 프롬프트 구간을 입력합니다. 모든 구간 길이의 합은 전체 영상 길이와 같아야 합니다.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string",
            "format": "str"
          },
          "duration": {
            "type": "integer",
            "format": "int_slider_with_range",
            "minimum": 3,
            "maximum": 15,
            "default": 5
          }
        }
      },
      "maxItems": 20,
      "minItems": 0
    },
    "start_image_url": {
      "title": "시작 이미지",
      "description": "영상의 시작 프레임입니다. jpg, jpeg, png, bmp, webp 형식을 지원합니다.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
    },
    "end_image_url": {
      "title": "종료 이미지",
      "description": "두 프레임 사이 전환을 제어하는 선택형 종료 이미지입니다. jpg, jpeg, png, bmp, webp 형식을 지원합니다.",
      "type": "string"
    },
    "duration": {
      "title": "길이",
      "description": "생성할 영상의 전체 길이(초)입니다.",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 10
    },
    "generate_audio": {
      "title": "오디오 생성",
      "description": "활성화하면 영상과 함께 오디오를 생성합니다.",
      "type": "boolean",
      "default": true
    },
    "elements": {
      "title": "참조 요소",
      "description": "참조 이미지와 영상 구간을 비롯해 생성에 사용할 입력 자료입니다.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "frontal_image_url": {
            "type": "string",
            "format": "image_uri",
            "description": "피사체의 정면 참조 이미지입니다."
          },
          "reference_image_urls": {
            "type": "array",
            "format": "image_uris",
            "items": {
              "type": "string",
              "format": "image_uri"
            },
            "description": "렌더링 방향을 잡는 추가 참조 이미지 URL입니다."
          },
          "video_url": {
            "type": "string",
            "format": "video_uri",
            "description": "움직임을 참조할 선택형 원본 영상입니다."
          }
        }
      },
      "minItems": 0,
      "maxItems": 3
    },
    "shot_type": {
      "title": "샷 유형",
      "description": "카메라 숏과 장면 구도를 처리하는 방식을 지정합니다.",
      "type": "string",
      "enum": [
        "customize"
      ],
      "default": "customize"
    },
    "negative_prompt": {
      "title": "네거티브 프롬프트",
      "description": "",
      "type": "string"
    },
    "cfg_scale": {
      "title": "가이던스 강도",
      "description": "프롬프트 반영 정도를 조절하는 CFG(Classifier-Free Guidance) 값입니다.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0.5
    }
  }
}

출력 스키마

{
  "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"
        }
      }
    }
  }
}

RunComfy

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

1. 시작하기

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
  }'

3. API 참조

요청 제출

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science.",
    "start_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
  }'

요청 상태 확인

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)

5. 스키마

입력 스키마

{
  "type": "object",
  "title": "입력 스키마",
  "required": [
    "prompt",
    "start_image_url"
  ],
  "properties": {
    "prompt": {
      "title": "프롬프트",
      "description": "",
      "type": "string",
      "default": "Bring this still photograph to life in native 4K with hyper-detailed motion. The young American ceramic artist's hands gently cradle and shape the spinning gray clay vessel — the wheel rotates with smooth controlled motion, the soft clay walls rise and slim under her thumbs, a thin glistening ribbon of water trickles continuously down the side, and a few fine droplets of clay-water flick outward in slow motion catching the light. Loose strands of her dirty-blonde hair sway gently, her chest rises and falls with steady calm breathing, eyes stay focused, a small subtle smile tugs at her lips, the linen apron shifts almost imperceptibly. Behind her, dust motes drift through the warm shaft of honey golden-hour light streaming through the multi-pane windows, dried botanicals sway slightly, and faint shadows shift across the whitewashed brick wall as the sun moves. The camera slowly pushes in from a tight medium close-up to an extreme close-up of the wet clay vessel and her glistening fingers, then drifts back up to her face. Ambient sound: the soft whir of the pottery wheel, water droplets, the rustle of linen, distant Portland street ambience, and a warm vinyl indie-folk record playing low. Native-4K hyper-detailed textures — wet clay surface sheen, fingertip ridges, water droplets, hair strands, linen apron weave, brick grain, wood shelf knots — shot on RED Komodo 6K, 50mm anamorphic, shallow depth of field, Kodak Portra color science."
    },
    "multi_prompt": {
      "title": "다중 프롬프트 구간",
      "description": "장면 전환을 위한 여러 프롬프트 구간을 입력합니다. 모든 구간 길이의 합은 전체 영상 길이와 같아야 합니다.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string",
            "format": "str"
          },
          "duration": {
            "type": "integer",
            "format": "int_slider_with_range",
            "minimum": 3,
            "maximum": 15,
            "default": 5
          }
        }
      },
      "maxItems": 20,
      "minItems": 0
    },
    "start_image_url": {
      "title": "시작 이미지",
      "description": "영상의 시작 프레임입니다. jpg, jpeg, png, bmp, webp 형식을 지원합니다.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7353/media-files/input.png"
    },
    "end_image_url": {
      "title": "종료 이미지",
      "description": "두 프레임 사이 전환을 제어하는 선택형 종료 이미지입니다. jpg, jpeg, png, bmp, webp 형식을 지원합니다.",
      "type": "string"
    },
    "duration": {
      "title": "길이",
      "description": "생성할 영상의 전체 길이(초)입니다.",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 10
    },
    "generate_audio": {
      "title": "오디오 생성",
      "description": "활성화하면 영상과 함께 오디오를 생성합니다.",
      "type": "boolean",
      "default": true
    },
    "elements": {
      "title": "참조 요소",
      "description": "참조 이미지와 영상 구간을 비롯해 생성에 사용할 입력 자료입니다.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "frontal_image_url": {
            "type": "string",
            "format": "image_uri",
            "description": "피사체의 정면 참조 이미지입니다."
          },
          "reference_image_urls": {
            "type": "array",
            "format": "image_uris",
            "items": {
              "type": "string",
              "format": "image_uri"
            },
            "description": "렌더링 방향을 잡는 추가 참조 이미지 URL입니다."
          },
          "video_url": {
            "type": "string",
            "format": "video_uri",
            "description": "움직임을 참조할 선택형 원본 영상입니다."
          }
        }
      },
      "minItems": 0,
      "maxItems": 3
    },
    "shot_type": {
      "title": "샷 유형",
      "description": "카메라 숏과 장면 구도를 처리하는 방식을 지정합니다.",
      "type": "string",
      "enum": [
        "customize"
      ],
      "default": "customize"
    },
    "negative_prompt": {
      "title": "네거티브 프롬프트",
      "description": "",
      "type": "string"
    },
    "cfg_scale": {
      "title": "가이던스 강도",
      "description": "프롬프트 반영 정도를 조절하는 CFG(Classifier-Free Guidance) 값입니다.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0.5
    }
  }
}

출력 스키마

{
  "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"
        }
      }
    }
  }
}

필수 시작 이미지와 선택형 종료 이미지를 바탕으로 네이티브 4K 시네마틱 영상을 구현합니다. 다중 프롬프트 전환, 참조 요소 고정, 동기화 오디오를 지원합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

필수 시작 이미지와 선택형 종료 이미지를 바탕으로 네이티브 4K 시네마틱 영상을 구현합니다. 다중 프롬프트 전환, 참조 요소 고정, 동기화 오디오를 지원합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

Kling V3.0 4K Image-to-Video: 모델 페이지와 API에서 네이티브 4K 이미지 애니메이션 생성 | RunComfy

필수 시작 이미지와 선택형 종료 이미지를 바탕으로 네이티브 4K 시네마틱 영상을 구현합니다. 다중 프롬프트 전환, 참조 요소 고정, 동기화 오디오를 지원합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

Kling V3.0 4K Image-to-Video: 모델 페이지와 API에서 네이티브 4K 이미지 애니메이션 생성 | RunComfy

필수 시작 이미지와 선택형 종료 이미지를 바탕으로 네이티브 4K 시네마틱 영상을 구현합니다. 다중 프롬프트 전환, 참조 요소 고정, 동기화 오디오를 지원합니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마