Kling Video 3.0은 최대 15초의 시네마틱 비디오를 생성하는 Kuaishou의 플래그십 텍스트/이미지-비디오 모델입니다. 멀티샷 제어, 네이티브 오디오, 시작/종료 프레임 이미지, 전용 4K 모드를 지원합니다.
콘솔의 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-video",
"input": {
"mode": "pro",
"prompt": "First-person POV of a roller coaster plunging into the mouth of an erupting volcano. The track spirals down through rivers of glowing orange lava, sparks and embers flying past the camera. The coaster banks hard around a pillar of molten rock, then launches upward through a vent, bursting out of the volcano's crater into a dazzling sunset sky above the clouds. Wind roaring, riders screaming with excitement, the deep rumble of the volcano.",
"duration": 15,
"aspect_ratio": "16:9",
"generate_audio": true
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 비디오 생성을 위한 텍스트 프롬프트 (최대 2500자) |
mode | string | No | pro | 'standard'는 720p, 'pro'는 1080p, '4k'는 4K 생성 standardpro4k |
duration | integer | No | 5 | 비디오 길이 초 (3~15) |
start_image | string | No | - | 첫 프레임 이미지 (.jpg/.jpeg/.png, 최대 10MB, 최소 300px, 비율 1:2.5~2.5:1) |
end_image | string | No | - | 마지막 프레임 이미지 (start_image 필요) |
aspect_ratio | string | No | 16:9 | 화면 비율. start_image 제공 시 무시됨 16:99:161:1 |
multi_prompt | string | No | - | 멀티샷 모드용 샷 정의 JSON 배열, 예: [{"prompt":"...","duration":3}] (최대 6샷, 샷당 최소 1초, 합계는 duration과 일치해야 함) |
generate_audio | boolean | No | false | 비디오의 네이티브 오디오 생성 (standard/pro 등급에서 초당 가격 상승) |
negative_prompt | string | No | - | 비디오에 나타나지 않았으면 하는 요소 (최대 2500자) |
이 모델의 start_imageend_image 파라미터에 파일을 전달하는 방법은 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-video" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:start_image=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "kwaivgi/kling-v3-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-video",
"input": {
"mode": "pro",
"prompt": "First-person POV of a roller coaster plunging into the mouth of an erupting volcano. The track spirals down through rivers of glowing orange lava, sparks and embers flying past the camera. The coaster banks hard around a pillar of molten rock, then launches upward through a vent, bursting out of the volcano's crater into a dazzling sunset sky above the clouds. Wind roaring, riders screaming with excitement, the deep rumble of the volcano.",
"duration": 15,
"aspect_ratio": "16:9",
"generate_audio": true
}
}'가장 저렴한 등급에서 한 번의 생성으로 만드는 3개의 일관된 샷
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-video",
"input": {
"mode": "standard",
"prompt": "A day in the life of a lighthouse keeper on a remote northern island",
"multi_prompt": "[{\"prompt\":\"Dawn breaks over a rocky island, the lighthouse silhouetted against pink clouds\",\"duration\":3},{\"prompt\":\"The keeper climbs the spiral staircase, lantern light flickering on stone walls\",\"duration\":3},{\"prompt\":\"Aerial pull-back reveals the lighthouse beam sweeping across a stormy sea at dusk\",\"duration\":3}]",
"duration": 9,
"aspect_ratio": "16:9",
"generate_audio": false
}
}'