이미지 기반 비디오 생성

요청에는 시작 프레임, 선택적 종료 프레임 및 생성 매개변수를 제출할 수 있습니다.

POST/kling/v1/videos/image2video

시작 프레임 이미지와 선택적 종료 프레임으로 Kling 네이티브 이미지 기반 비디오 작업을 생성합니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

Kling 네이티브 이미지 기반 비디오 요청입니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

Kling 네이티브 모델 ID입니다. 예를 들어 kling-v2-5-turbo, kling-v2-6입니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

prompt*string

긍정 프롬프트이며 2500자를 초과할 수 없습니다.

길이length <= 2500

negative_prompt?string

부정 프롬프트입니다.

길이length <= 2500

init_image*string

이미지 기반 비디오 생성의 시작 프레임 이미지 URL입니다. 이미지 기반 비디오 생성 시 필수입니다.

길이1 <= length

image_tail?string

선택적 종료 프레임 이미지 URL입니다. 종료 프레임을 사용하려면 mode=pro를 설정해야 합니다. kling-v2-6의 std 모드에서 이 필드를 전달하면 1201을 반환합니다.

mode?string

생성 모드입니다. image_tail을 사용하면 pro여야 합니다.

허용 값

"std"
"pro"

aspect_ratio?string

출력 화면 비율입니다.

기본값"16:9"

허용 값

"16:9"
"9:16"
"1:1"

duration_string?string

비디오 길이이며 단위는 초입니다.

허용 값

"5"
"10"

cfg_scale?number

프롬프트 일관성 강도입니다.

범위0 <= value <= 1

sound?string

사운드 생성 여부입니다. V2.6 및 이후 모델만 지원합니다.

허용 값

"on"
"off"

voice_list?array<>

참조 음색 목록입니다.

항목items <= 2

callback?string

작업 상태 callback 주소입니다.

형식uri

params?string

callback에 그대로 전달하는 매개변수입니다.

응답 본문

`application/json`

curl -X POST "https://example.com/kling/v1/videos/image2video" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "대상의 스타일을 유지하면서 인물이 카메라를 향해 천천히 걸어오게 해 주세요",
    "negative_prompt": "흐릿함, 낮은 선명도",
    "init_image": "https://example.com/input-image.jpg",
    "image_tail": "https://example.com/end-frame.jpg",
    "mode": "pro",
    "aspect_ratio": "16:9",
    "duration_string": "10",
    "cfg_scale": 0.6,
    "sound": "on",
    "callback": "https://example.com/kling/callback",
    "params": "user_id_123"
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "task_id": "task_id_here",
    "task_status": "submitted",
    "created_at": 1640995200000,
    "updated_at": 1640995200000
  }
}

이미지 기반 비디오 생성

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`