Skip to main content
POST

인증

string
필수
모든 API 엔드포인트는 Bearer Token 인증이 필요합니다API 키 받기:API 키 관리 페이지에서 API 키를 받으세요요청 헤더에 추가:

요청 매개변수

string
필수
비디오 생성 모델 이름지원 모델:
  • kling-video-o1 - Kling Video O1 (추론 강화, 최고 품질)
string
필수
긍정 텍스트 프롬프트<<<image_N>>> 구문으로 image_urls의 이미지를 참조할 수 있습니다. N은 1부터 시작합니다.예시: "<<<image_1>>>의 인물이 카메라를 향해 손을 흔든다"
이미지가 제공되었지만 프롬프트에 <<<image_N>>> 참조가 없는 경우, 시스템이 자동으로 프롬프트 앞에 <<<image_1>>>을 추가합니다.
string
기본값:"std"
생성 모드옵션:
  • std - 표준 모드 (720P)
  • pro - 프로페셔널 모드 (1080P)
기본값: std
integer
기본값:"5"
비디오 길이 (초)옵션: 5 또는 10기본값: 5
string
기본값:"16:9"
비디오 화면 비율옵션:
  • 16:9 - 가로
  • 9:16 - 세로
  • 1:1 - 정사각형
기본값: 16:9
array<url>
이미지 참조를 위한 이미지 URL 배열프롬프트에서 <<<image_N>>> 구문으로 해당 위치의 이미지를 참조합니다 (N은 1부터 시작)예시: ["https://example.png"]
  • 이미지 URL은 공개적으로 접근 가능해야 하며 핫링크 보호가 없어야 합니다
  • 이미지-비디오 모드에서는 aspect_ratio가 실제 이미지 비율로 대체될 수 있습니다
  • 이미지는 최대 2장이며, 배열의 첫 번째가 시작 프레임, 두 번째가 끝 프레임입니다
array<object>
역할 기반 이미지 배열이며, 이미지-비디오에서 권장됩니다.각 항목 형식: { "url": "...", "role": "..." }
  • first_frame: 첫 프레임
  • last_frame: 끝 프레임
  • reference: 참조 이미지
  • image_urlsimage_with_roles 는 둘 중 하나만 사용하고, 동시에 전달하지 마세요.
  • 이미지가 2장을 초과하면 시작/끝 프레임 설정이 지원되지 않습니다.
array
참조 비디오 목록(URL 방식), 최대 1개까지 지원합니다.refer_type으로 유형을 구분합니다:
  • base: 편집 대상 비디오(기본값)
  • feature: 특징 참조 비디오
keep_original_sound로 원본 오디오 유지 여부를 설정합니다:
  • no: 유지하지 않음(기본값)
  • yes: 원본 오디오 유지
요청 형식:
  • video_url은 비워둘 수 없으며, 비디오 URL은 접근 가능해야 합니다
  • refer_type=base인 경우:
    • 비디오 시작/끝 프레임을 정의할 수 없습니다
    • 참조 비디오는 3-10초여야 합니다
    • 생성 비디오 길이는 업로드한 비디오를 따릅니다
  • refer_type=feature이고 video_url이 비어 있지 않은 경우:
    • image_urls에는 첫 프레임 이미지만 업로드할 수 있습니다
  • 비디오 요구사항: MP4/MOV만 지원; 길이 3초 이상; 해상도 720px-2160px; 프레임레이트 24-60fps(출력은 24fps); 크기 200MB 이하

이미지 참조 구문

Video O1 모델은 <<<image_N>>> 구문을 사용하여 프롬프트에서 이미지를 참조하며, 통합된 텍스트-비디오/이미지-비디오 경험을 제공합니다:
자동 참조: image_urls가 제공되었지만 프롬프트에 <<<image_N>>> 참조가 없는 경우, 시스템이 자동으로 프롬프트 앞에 <<<image_1>>>을 추가합니다.

응답

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

사용 시나리오

시나리오 1: 텍스트-비디오 (최고 품질)

시나리오 2: 이미지 참조 (단일 이미지)

시나리오 3: 다중 이미지 참조

시나리오 4: 이미지 제공 시 명시적 참조 없음 (자동 추가)

시스템이 자동으로 프롬프트 앞에 <<<image_1>>>을 추가하여, "<<<image_1>>>인물이 천천히 고개를 돌려 미소 짓는다"와 동일하게 됩니다.
작업 결과 조회비디오 생성은 비동기 작업으로, 제출 시 task_id가 반환됩니다. 작업 상태 가져오기 엔드포인트를 사용하여 생성 진행 상황과 결과를 조회할 수 있습니다.