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

Kling V3.0 4K: 네이티브 4K 텍스트 영상 생성 | RunComfy

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

동기화된 대사, 다중 장면 스토리, 캐릭터 일관성, 개발자용 API를 갖춘 네이티브 4K 영상을 오디오 사용 여부와 관계없이 일정한 초당 요금으로 생성합니다.

목차

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

1. 시작하기

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Native-4K cinematic multi-shot of a Brooklyn artisan coffee shop on a rainy autumn morning. Wide establishing shot through a fogged-up window: a bearded American barista in a denim apron stands behind a polished copper espresso machine, brass fixtures glowing under warm Edison bulbs, exposed brick and hanging plants in the background. Cut to an extreme macro close-up of milk being steamed, micro-foam swirling with visible bubbles and droplets. Cut to a top-down macro shot of his hands pouring a perfect rosetta latte art into a matte ceramic cup, golden crema rippling in slow motion. Cut to a young woman in a cream cable-knit sweater receiving the cup, soft window light catching freckles on her cheeks, green eyes warming as she smiles. Final shot: a slow dolly-out reveals the cozy industrial interior — vinyl records spinning, a chalkboard menu, raindrops streaking the window. Sound of espresso machine hissing, gentle rain on glass, soft indie acoustic guitar. Hyper-detailed textures: yarn weave, hair strands, crema bubbles, raindrop refraction — shot on RED Komodo 6K, anamorphic lenses, shallow depth of field, Kodak Portra color science."
  }'

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/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Native-4K cinematic multi-shot of a Brooklyn artisan coffee shop on a rainy autumn morning. Wide establishing shot through a fogged-up window: a bearded American barista in a denim apron stands behind a polished copper espresso machine, brass fixtures glowing under warm Edison bulbs, exposed brick and hanging plants in the background. Cut to an extreme macro close-up of milk being steamed, micro-foam swirling with visible bubbles and droplets. Cut to a top-down macro shot of his hands pouring a perfect rosetta latte art into a matte ceramic cup, golden crema rippling in slow motion. Cut to a young woman in a cream cable-knit sweater receiving the cup, soft window light catching freckles on her cheeks, green eyes warming as she smiles. Final shot: a slow dolly-out reveals the cozy industrial interior — vinyl records spinning, a chalkboard menu, raindrops streaking the window. Sound of espresso machine hissing, gentle rain on glass, soft indie acoustic guitar. Hyper-detailed textures: yarn weave, hair strands, crema bubbles, raindrop refraction — shot on RED Komodo 6K, anamorphic lenses, shallow depth of field, Kodak Portra color science."
  }'

요청 상태 확인

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"
  ],
  "properties": {
    "prompt": {
      "title": "프롬프트",
      "description": "장면, 움직임, 카메라 스타일, 분위기를 텍스트로 설명합니다.",
      "type": "string",
      "default": "Native-4K cinematic multi-shot of a Brooklyn artisan coffee shop on a rainy autumn morning. Wide establishing shot through a fogged-up window: a bearded American barista in a denim apron stands behind a polished copper espresso machine, brass fixtures glowing under warm Edison bulbs, exposed brick and hanging plants in the background. Cut to an extreme macro close-up of milk being steamed, micro-foam swirling with visible bubbles and droplets. Cut to a top-down macro shot of his hands pouring a perfect rosetta latte art into a matte ceramic cup, golden crema rippling in slow motion. Cut to a young woman in a cream cable-knit sweater receiving the cup, soft window light catching freckles on her cheeks, green eyes warming as she smiles. Final shot: a slow dolly-out reveals the cozy industrial interior — vinyl records spinning, a chalkboard menu, raindrops streaking the window. Sound of espresso machine hissing, gentle rain on glass, soft indie acoustic guitar. Hyper-detailed textures: yarn weave, hair strands, crema bubbles, raindrop refraction — shot on RED Komodo 6K, anamorphic lenses, shallow depth of field, Kodak Portra color science."
    },
    "negative_prompt": {
      "title": "네거티브 프롬프트",
      "description": "영상에서 제외할 요소입니다.",
      "type": "string"
    },
    "duration": {
      "title": "길이",
      "description": "영상 길이를 초 단위로 지정합니다.",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 5
    },
    "aspect_ratio": {
      "title": "화면비",
      "description": "생성 영상의 출력 비율입니다.",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "cfg_scale": {
      "title": "CFG 스케일",
      "description": "프롬프트를 반영하는 강도입니다.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0.5
    },
    "sound": {
      "title": "오디오",
      "description": "영상에 맞춰 동기화 오디오를 생성합니다.",
      "type": "boolean",
      "default": true
    },
    "multi_prompt": {
      "title": "멀티 프롬프트",
      "description": "장면 전환과 전개를 안내하는 추가 프롬프트 구간입니다. multi_prompt에 포함된 구간의 길이 합계는 전체 영상 길이와 같아야 합니다.",
      "type": "array",
      "items": {
        "prompt": {
          "title": "프롬프트",
          "description": "장면 전환 및 진행을 안내하는 추가 프롬프트 세그먼트입니다.",
          "type": "string",
          "format": "str"
        },
        "duration": {
          "title": "지속",
          "description": "이 프롬프트 구간의 길이(초)입니다.",
          "type": "integer",
          "format": "int_slider_with_range",
          "minimum": 3,
          "maximum": 15,
          "default": 5
        }
      },
      "maxItems": 20,
      "minItems": 0
    },
    "shot_type": {
      "title": "숏 유형",
      "description": "편집 모드를 지정합니다. intelligent는 범위를 자동으로 정하는 기본 설정이고, customize는 사용자가 직접 설정하는 모드입니다.",
      "type": "string",
      "enum": [
        "customize"
      ],
      "default": "customize"
    }
  }
}

출력 스키마

{
  "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
  • 트위터
지원
  • 디스코드
  • 이메일
  • 시스템 상태
  • 제휴사
비디오 모델
  • MiniMax H3
  • Minimax H3 Image to Video
  • FLUX 3 Video
  • Happy Horse 1.1 reference to video
  • Wan 2.6 Flash
  • Hailuo 2.3 Fast Standard
  • 모든 모델 보기 →
이미지 모델
  • FLUX 3 Image
  • Seedream 5.0 Pro Image Edit
  • Flux 2 Flash Edit
  • seedream 4.0
  • GPT Image 2 Image Edit
  • Nano Banana Pro
  • 모든 모델 보기 →
법적 고지
  • 서비스 약관
  • 개인정보 보호정책
  • 쿠키 정책
RunComfy
저작권 2026 RunComfy. All Rights Reserved.

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