Kling Video 3.0 Omni는 텍스트, 이미지, 레퍼런스 이미지, 기존 비디오로부터 영상을 생성·편집하는 통합 멀티모달 비디오 모델입니다. 텍스트-비디오, 이미지-비디오, 레퍼런스 기반 생성, 비디오 편집을 네이티브 오디오와 멀티샷 제어로 하나의 모델에 통합했습니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "kwaivgi/kling-v3-omni-video",
"input": {
"mode": "pro",
"prompt": "A Wes Anderson style movie trailer with symmetrical framing and pastel colors, ending on the full cast standing on the hotel steps",
"duration": 15,
"aspect_ratio": "16:9",
"generate_audio": true
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 텍스트 프롬프트 (최대 2500자). <<<image_1>>>, <<<video_1>>> 형식의 레퍼런스 참조 지원 |
start_image | string | No | - | 이미지-비디오 변환용 첫 프레임 이미지 |
end_image | string | No | - | 마지막 프레임 이미지 (start_image 필요) |
reference_images | array | No | - | 요소·장면·스타일용 레퍼런스 이미지 (비디오 미사용 시 최대 7장, 사용 시 4장) |
reference_video | string | No | - | 스타일·카메라 레퍼런스 또는 비디오 편집용 레퍼런스 비디오 (3~10초) |
video_reference_type | string | No | feature | 'feature'는 스타일·카메라 레퍼런스, 'base'는 비디오 편집 featurebase |
keep_original_sound | boolean | No | true | 레퍼런스 비디오의 원본 사운드 유지 여부 |
generate_audio | boolean | No | false | 네이티브 오디오 생성. 레퍼런스 비디오와 동시 사용 불가 |
mode | string | No | pro | 'standard'는 720p, 'pro'는 1080p, '4k'는 4K 생성 (4k는 reference_video 미지원) standardpro4k |
aspect_ratio | string | No | 16:9 | 화면 비율. 시작 프레임이나 비디오 편집을 사용하지 않을 때 필수 16:99:161:1 |
duration | integer | No | 5 | 비디오 길이 초 (3~15). 비디오 편집(base) 모드에서는 무시됨 |
multi_prompt | string | No | - | 멀티샷 모드용 샷 정의 JSON 배열, 예: [{"prompt":"...","duration":3}] (최대 6샷) |
이 모델의 start_imageend_imagereference_imagesreference_video 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=kwaivgi/kling-v3-omni-video" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:start_image=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "kwaivgi/kling-v3-omni-video",
"input": {
"prompt": "your prompt here",
"start_image": "https://example.com/image.jpg"
}
}POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
네이티브 오디오를 켠 pro 등급의 멀티샷 시네마틱 트레일러
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "kwaivgi/kling-v3-omni-video",
"input": {
"mode": "pro",
"prompt": "A Wes Anderson style movie trailer with symmetrical framing and pastel colors, ending on the full cast standing on the hotel steps",
"duration": 15,
"aspect_ratio": "16:9",
"generate_audio": true
}
}'빠른 반복 작업을 위한 가장 저렴한 등급, 오디오 생성은 꺼둠
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "kwaivgi/kling-v3-omni-video",
"input": {
"mode": "standard",
"prompt": "A paper airplane gliding through a sunlit office, weaving between desks",
"duration": 5,
"aspect_ratio": "16:9",
"generate_audio": false
}
}'