Fal.AI를 통해 제공되는 Kling O3 네이티브 4K 비디오-투-비디오 레퍼런스 모델입니다. 레퍼런스 비디오(@Video1)의 카메라 움직임·페이싱·프레이밍을 따르는 새 4K 샷을 생성하면서 엘리먼트 이미지(@Element1)의 캐릭터·사물과 스타일 이미지(@Image1)를 녹여 넣습니다. 업스케일 없이 4K로 바로 출력, 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/o3/4k/video-to-video/reference",
"input": {
"prompt": "Integrate @Element1 in the scene. Style video should be following watercolor style of @Image1",
"video_url": "https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-reference/video_reference.mp4",
"elements": [
{
"frontal_image_url": "https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-reference/element1_front.png",
"reference_image_urls": [
"https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-reference/element1_reference1.png"
]
}
],
"image_urls": [
"https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-reference/image_url1.jpg"
],
"duration": "5",
"aspect_ratio": "auto"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 텍스트 프롬프트. 레퍼런스 비디오는 @Video1, 엘리먼트 이미지는 @Element1, 스타일 이미지는 @Image1로 인용. 최대 2500자 |
video_url | string | Yes | - | 레퍼런스 비디오. .mp4/.mov, 3~15초, 720~3840px, 23~60fps, 최대 200MB |
duration | string | No | 5 | 출력 비디오 길이 초 (3~15). 초당 과금 3456789101112131415 |
aspect_ratio | string | No | auto | 생성 비디오의 화면 비율 auto16:99:161:1 |
elements | array | No | - | 포함할 캐릭터·사물. 각각 frontal_image_url과 reference_image_urls(1~3장)로 구성, @Element1로 인용. elements와 image_urls 합계 최대 4개 |
image_urls | array | No | - | 스타일·외형 레퍼런스 이미지. @Image1로 인용. elements와 image_urls 합계 최대 4개 |
keep_audio | boolean | No | true | 입력 비디오의 원본 오디오 유지 |
enable_safety_checker | boolean | No | true | 세이프티 체커 활성화 |
이 모델의 video_urlimage_urls 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "fal-ai/kling-video/o3/4k/video-to-video/reference",
"input": {
"prompt": "your prompt here",
"video_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/o3/4k/video-to-video/reference" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:video_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로도 제공 |
레퍼런스 비디오를 따르며 엘리먼트를 넣고 수채화 스타일 적용
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/o3/4k/video-to-video/reference",
"input": {
"prompt": "Integrate @Element1 in the scene. Style video should be following watercolor style of @Image1",
"video_url": "https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-reference/video_reference.mp4",
"elements": [
{
"frontal_image_url": "https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-reference/element1_front.png",
"reference_image_urls": [
"https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-reference/element1_reference1.png"
]
}
],
"image_urls": [
"https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-reference/image_url1.jpg"
],
"duration": "5",
"aspect_ratio": "auto"
}
}'