Kling 4.0

Kling 4.0은 2026년 9월에 발표된 Kuaishou의 동영상 모델입니다. 하나의 모델 ID는 5가지 모드를 포함합니다: 텍스트로 동영상, 최대 10개 프레임의 이미지로 동영상, 이미지, 동영상 및 오디오의 레퍼런스 생성, 동영상 편집 및 동영상 연장. 모든 클립은 720p 또는 1080p에서 스테레오 사운드와 함께 3~30초입니다. 요청을 보내고, 반환된 작업 ID를 유지하고, 작업에서 완성된 동영상을 읽습니다. 미디어는 URL로 들어갑니다.

모델 ID

현재 가격은 모델 페이지에서 확인하세요.

빠른 예제

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4-0",
    "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, signs shimmering in the puddles, the camera tracking low beside her. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

엔드포인트

POST https://api.seedrouter.ai/v1/videos/generations

응답은 완성된 동영상이 아닌 작업입니다({"id": "task_...", "status": "processing"}). 결과를 위해 GET /v1/tasks/{task_id}를 폴링합니다. API 키는 서버 측 코드에 유지합니다.

파라미터

모든 클립은 스테레오 사운드와 함께 제공됩니다; 사운드 스위치가 없습니다. mode, negative_prompt, watermark 또는 멀티샷 필드가 없습니다. 스키마는 엄격합니다: 알 수 없는 필드는 무시되지 않고 거부됩니다. callback_url은 사용할 수 없습니다; 대신 작업을 폴링합니다.

모드

모드는 보내는 미디어와 omni_reference_task_type을 따릅니다:

프레임 및 레퍼런스 미디어는 하나의 요청으로 혼합될 수 없습니다. 레퍼런스 동영상이나 오디오 옆에서 image_urls는 omni_reference_task_type: "reference"와 함께만 레퍼런스 이미지로 읽혀집니다; 그렇지 않으면 reference_image 역할을 사용합니다. edit 또는 extend 없는 video_url은 거부됩니다.

키프레임

{
  "model": "kling-4-0",
  "prompt": "A girl walks from the window to the door, then looks back and smiles",
  "image_with_roles": [
    {"url": "https://example.com/1.png", "role": "first_frame"},
    {"url": "https://example.com/2.png", "role": "keyframe"},
    {"url": "https://example.com/3.png", "role": "last_frame"}
  ],
  "duration": 10
}

레퍼런스 생성

{
  "model": "kling-4-0",
  "prompt": "The woman from @Image1 walks along the beach with the camera movement of @Video1",
  "image_with_roles": [{"url": "https://example.com/woman.png", "role": "reference_image"}],
  "video_urls": ["https://example.com/camera.mp4"],
  "aspect_ratio": "auto",
  "duration": 5
}

편집

{
  "model": "kling-4-0",
  "prompt": "Change the scene to a snowy winter evening",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/in.mp4"
}

입력 동영상은 최소 3초 이상이어야 합니다; 처음 30초만 사용됩니다. duration 없이, 출력은 입력 동영상을 따릅니다.

연장

{
  "model": "kling-4-0",
  "prompt": "The camera keeps moving forward as the sky grows darker",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 5
}

연장은 입력 동영상의 마지막 프레임에서 계속되고 원본 + 새 부분을 반환합니다. 끝나는 위치를 선택하려면 last_frame_image를 추가합니다.

미디어 입력

이미지, 동영상 및 오디오는 공개 HTTP(S) URL입니다. Base64 데이터 URI는 허용되지 않습니다: 파일을 자신의 저장소에 업로드하고 해당 URL을 전달합니다. 이미지, 동영상 및 오디오는 최대 15개 레퍼런스 파일입니다.

가격 책정 차원

모델 가격 책정 섹션에서 현재 요율을 확인하세요. Kling 4.0은 동영상 초 단위로 해상도로 정해진 요율로 청구됩니다:

text, image, reference without videos:  cost = duration × standard rate
extend:                                 cost = new seconds × standard rate
edit, reference with videos:            cost = (output + max(output, input)) × video-input rate

input은 입력 동영상의 합계 길이이며, 전체 초로 반올림되고 30초로 한정됩니다. 요청이 수락될 때 측정되므로 예약된 금액은 청구된 금액입니다. 길이를 읽을 수 없는 동영상은 아무것도 청구되기 전에 거부됩니다. 예: 5.2초 동영상을 3초 결과로 편집하면 3 + 6 = 9초가 청구됩니다. 실패한 작업은 청구되지 않습니다.

출력 스키마

제출은 작업을 반환합니다:

{"id": "task_...", "model": "kling-4-0", "status": "processing", "created_at": 1789689600}

작업 가져오기

GET https://api.seedrouter.ai/v1/tasks/{task_id}

status가 completed 또는 failed일 때까지 10~20초마다 폴링합니다. 폴링 중 네트워크 시간 초과는 생성이 실패했다는 의미가 아닙니다: 작업 ID를 유지하고 확인을 재개합니다. 진행 상황을 확인하기 위해 다른 작업을 만들지 마십시오.

완료된 작업

{
  "id": "task_...",
  "model": "kling-4-0",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689800,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

테스트에서 3초 720p 클립은 1280 × 720에서 스테레오 AAC 트랙이 있는 MP4(H.264)로 반환되었으며, 제출 후 2분 41초에서 4분 22초 사이입니다. 연장된 5.2초 동영상은 8.1초 길이로 반환되었습니다.

오류

작업이 생성되기 전에 거부된 요청은 error 개체가 있는 HTTP 오류를 반환하며 청구되지 않습니다. 수락 후 실패한 작업은 쿼리될 때 HTTP 200을 반환하고 status: "failed" 및 error 개체가 있습니다.

공유 오류 카탈로그에서 코드, HTTP 상태 및 재시도 지침을 참조하세요.

{
  "id": "task_...",
  "model": "kling-4-0",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

제출 자체가 시간 초과되면, 다시 제출하기 전에 작업을 확인하세요: 첫 번째 요청이 수락되었을 수도 있습니다.

팁

• 피사체, 장소, 카메라 움직임, 빛과 사운드를 설명합니다; 클립의 오디오는 프롬프트를 따릅니다.
• 720p로 초안을 작성한 다음 동일한 요청으로 최종 샷을 1080p로 렌더링합니다.
• 더 긴 클립에 키프레임을 지정하여 장면이 원하는 곳으로 이동하도록 합니다.
• "텍스트 없음, 로고 없음"을 추가하여 발명된 마크를 유지합니다.

관련

• Kling 4.0 Playground 및 가격
• Kling 3.0 API 참조
• OpenAPI 다운로드
• 복사 가능한 Markdown