Fal.AI를 통해 제공되는 Kling 3.0 Turbo Pro 이미지-비디오 모델입니다. 첫 프레임 이미지를 네이티브 오디오가 포함된 고품질 1080p 비디오로 애니메이션화하며, 향상된 립싱크와 멀티샷 스토리보드를 지원합니다. 3~15초.
콘솔의 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": "fal-ai/kling-video/v3/turbo/pro/image-to-video",
"input": {
"prompt": "The dappled light shifts gently across her face as leaves sway, a strand of hair drifts, she softly smiles and looks to the lens. The camera holds close. Photorealistic, fresh, intimate.",
"image_url": "https://v3b.fal.media/files/b/0a9ea0aa/R_9HxGaCuonczhLfscQnM_579d59f2510345ad956fd95dba2c43b6.png",
"duration": "5"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | No | - | 움직임을 설명하는 선택 프롬프트 (2500자 이하 권장). multi_prompt와 함께 쓸 수 없습니다 |
image_url | string | Yes | - | 첫 프레임 이미지. jpg/jpeg/png, 최대 50MB, 한 변 최소 300px, 비율 1:2.5~2.5:1 |
duration | string | No | 5 | 비디오 길이 초 (3~15). 초당 과금. multi_prompt 사용 시 무시됩니다 3456789101112131415 |
multi_prompt | array | No | - | 멀티샷 스토리보드: {prompt, duration} 샷 1~6개, 합계 15초 이하. prompt와 함께 쓸 수 없습니다. 샷 합계와 무관하게 15초 최대 요금으로 과금됩니다 |
enable_safety_checker | boolean | No | true | 세이프티 체커 활성화 |
이 모델의 image_url 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "fal-ai/kling-video/v3/turbo/pro/image-to-video",
"input": {
"prompt": "your prompt here",
"image_url": "https://example.com/image.jpg"
}
}POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 없는 대신, 파일이 API 서버를 거치므로 요청 전체 10MB 제한이 적용됩니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=fal-ai/kling-video/v3/turbo/pro/image-to-video" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:image_url=@your_file.png"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로도 제공 |
프롬프트 하나로 5초 클립
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "fal-ai/kling-video/v3/turbo/pro/image-to-video",
"input": {
"prompt": "The dappled light shifts gently across her face as leaves sway, a strand of hair drifts, she softly smiles and looks to the lens. The camera holds close. Photorealistic, fresh, intimate.",
"image_url": "https://v3b.fal.media/files/b/0a9ea0aa/R_9HxGaCuonczhLfscQnM_579d59f2510345ad956fd95dba2c43b6.png",
"duration": "5"
}
}'샷별 프롬프트로 구성 (15초로 과금)
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "fal-ai/kling-video/v3/turbo/pro/image-to-video",
"input": {
"image_url": "https://example.com/keyframe.png",
"multi_prompt": [
{
"prompt": "Wide shot: she steps out of the cafe into the morning street",
"duration": "5"
},
{
"prompt": "Close-up: she smiles and raises her coffee cup to the camera",
"duration": "5"
}
]
}
}'