Skip to main content
POST

인증

string
필수
모든 API는 Bearer Token을 사용한 인증이 필요합니다API Key 발급:API Key 관리 페이지에 접속하여 API Key를 발급받으세요사용 시 요청 헤더에 다음을 추가합니다:

요청 파라미터

string
필수
비디오 생성 모델 이름지원되는 모델:
  • kling-3.0-turbo - Kling 3.0 Turbo
string
필수
텍스트 프롬프트업스트림 제한은 3072자 이하이며, 2500자 이하를 권장합니다.예시: "코기 한 마리가 해변을 달린다, 영화 같은 느낌, 황혼의 빛"
string
이미지 URL 또는 Base64를 지원합니다.
첫 프레임 이미지 업스트림 제한:
  • 형식: .jpg / .jpeg / .png
  • 크기: ≤ 50MB
  • 너비/높이: ≥ 300px
  • 종횡비: 1:2.5 ~ 2.5:1
string
기본값:"16:9"
비디오 종횡비선택 가능한 값:
  • 16:9 - 가로 화면
  • 9:16 - 세로 화면
  • 1:1 - 정사각형
기본값: 16:9
텍스트-투-비디오에서만 적용됩니다. 이미지-투-비디오 시 이 필드는 무효이며, 비디오 비율은 첫 프레임 이미지로 결정됩니다.
string
기본값:"720p"
비디오 해상도선택 가능한 값:
  • 720p
  • 1080p
기본값: 720p
integer
기본값:"5"
비디오 길이(초)값의 범위: 3-15(최소 3초, 최대 15초)기본값: 5⚠️ 주의: 반드시 순수 숫자를 입력해야 하며(예: 6), 따옴표를 붙이지 마세요. 그렇지 않으면 오류가 발생합니다
boolean
워터마크 추가 여부명시적으로 전달했을 때만 업스트림으로 전송되며, 전달하지 않으면 워터마크를 추가하지 않습니다.

텍스트-투-비디오 vs 이미지-투-비디오

시스템은 first_frame_image 제공 여부에 따라 생성 모드를 자동으로 판단합니다. 첫 프레임 이미지가 있으면 이미지-투-비디오, 없으면 텍스트-투-비디오로 처리되며, 사용자가 명시적으로 선언할 필요가 없습니다.

응답

integer
응답 상태 코드, 성공 시 200
array
반환 데이터 배열

사용 시나리오

시나리오 1: 텍스트-투-비디오(1080P)

시나리오 2: 텍스트-투-비디오(세로 화면 720P)

시나리오 3: 이미지-투-비디오(첫 프레임 이미지)

시나리오 4: 첫 프레임 이미지만으로 비디오 생성(프롬프트 없이)

시나리오 5: 멀티 샷 분할 화면(텍스트-투-비디오)

작업 결과 조회비디오 생성은 비동기 작업으로, 제출 후 task_id를 반환합니다. 작업 상태 조회 API를 사용하여 생성 진행 상황과 결과를 조회하세요.