Omni 동영상 생성
여러 유형의 참조 소재로 Kling 4.0 동영상을 생성·편집합니다.
feature_video는 영상의 특징과 움직임 리듬을 참조하며 base_video는 기존 영상을 편집합니다. 이미지·영상·요소·음성은 합계 최대 15개이며 유형별 제한도 적용됩니다. 요소와 음성은 기존 ID를 사용합니다. 이 페이지에는 소재 관리 API가 없습니다.
/kling/omni-video/kling-4.0프롬프트·이미지·영상·요소·음성으로 영상을 생성·편집합니다. feature_video는 참조, base_video는 편집용입니다. 다른 두 생성 API와 같은 Kling 4.0 모델을 사용합니다.
소재 유형과 참조
contents에는 프롬프트 항목 type: "prompt"가 필수입니다. 나머지는 필요에 따라 추가합니다. id는 프롬프트의 @reference에 사용하며 작업 내 모든 소재 참조 ID는 고유해야 합니다.
| 소재 | type | 소스와 필수 항목 |
|---|---|---|
| 이미지 | first_frame / middle_frame / last_frame / refer_image | url 필수, URL 또는 Base64, id 선택 |
| 영상 | feature_video / base_video | url 필수, 영상 URL, id 선택 |
| 요소 | element | element_id와 id 모두 필수 |
| 음성 | voice | voice_id와 id 모두 필수 |
element_id는 요소 API로 조회하는 시스템 생성 요소 ID입니다. voice_id는 음성 ID로, 맞춤 음성 API에서 얻거나 공식 시스템 프리셋을 사용합니다. 이 요청의 소재 참조 id와는 다른 매개변수입니다.
요소는 공식 요소 라이브러리 가이드, 음성 소스는 공식 음성 맞춤 설정 설명을 참고하세요. 해당 지역의 ID를 사용하며 다른 지역의 프리셋 ID를 재사용하지 마세요.
소재 제한
| 소재 | 형식·크기 | 치수·길이·개수 |
|---|---|---|
| 이미지 | JPG, JPEG, PNG, 각각 최대 30MB | 너비·높이 모두 300px 이상, 비율 2:5～5:2, 최대 10장 |
| 영상 | MP4, MOV, 각각 최대 300MB | 각 영상 및 입력 합계 3～30초, 너비·높이 700～4553px, 총 픽셀 8294400 이하, 비율 2:5～5:2, 입력 24～60fps, 출력 24fps |
| 요소 | 다중 이미지·영상 캐릭터 요소 | 최대 7개, 영상 캐릭터는 최대 3개 |
| 음성 | 기존 맞춤 음성·시스템 프리셋 | 최대 3개 |
소재 조합은 다음 조건도 충족해야 합니다:
- 이미지·영상·요소·음성 합계 15개 이하.
- 영상과 영상 캐릭터 요소 합계 5개 이하,
base_video는 최대 1개. - 입력 영상 총 길이에는
feature_video,base_video및 영상 캐릭터 요소의 원본 영상이 포함됩니다.
주요 오류와 해결 방법
| 응답·오류 | 확인 및 조치 |
|---|---|
HTTP 401, Invalid token | Bearer 형식과 API Key의 요청 사이트 확인 |
HTTP 400, contents cannot be empty | 비어 있지 않은 contents 배열 제공 |
HTTP 400, prompt cannot be empty | contents에 비어 있지 않은 type: "prompt" 텍스트 항목 추가 |
HTTP 400, contents[0].type ... is invalid | 지원 소재 유형과 오류 인덱스의 항목 확인 |
HTTP 400, Invalid element id | element_id 확인. 참조 id를 요소 ID 대신 사용하지 않음 |
HTTP 400, Invalid voice id | voice_id 확인. 참조 id를 음성 ID 대신 사용하지 않음 |
HTTP 400, invalid JSON request body | JSON 따옴표·쉼표·괄호·주석 확인 |
HTTP 400은 code/message/data 또는 error 객체일 수 있습니다. fail_to_fetch_task의 원인은 message에 있으며 code/message/request_id를 포함한 JSON 문자열일 수 있습니다. 요청 ID를 보관하고 API Key는 제공하지 마세요.