Kling 4.0 API 사용 방법: 모드, 키프레임, 레퍼런스, 편집 및 연장

Kling 4.0 API를 사용하려면 API 키를 만들고, 모델 ID kling-4-0 및 프롬프트가 있는 JSON 본문 1개를 POST한 다음, 반환되는 작업을 폴링하여 동영상 URL이 준비될 때까지 기다리십시오. 동일한 엔드포인트는 모든 5가지 모드를 포함합니다: 텍스트로 동영상, 최대 10개 프레임의 이미지로 동영상, 이미지, 동영상 및 오디오의 참고, 동영상 편집 및 연장. 보내는 미디어와 하나의 필드인 omni_reference_task_type이 실행되는 모드를 결정합니다.

이 가이드는 2026년 10월 22일에 실행된 요청 본문을 사용하여 각 모드를 살펴보고, 각 모드가 청구되는 방식과 아무것도 청구되기 전에 거부되는 요청을 보여줍니다.

첫 번째 요청 전에 필요한 것은?

1. API 키. API 키 페이지에서 생성하고 서버에 유지하세요. 브라우저 코드에 넣지 마세요.
2. 크레딧. 청구 페이지에서 잔액을 추가하세요. 크레딧은 만료되지 않으며, 실패한 작업은 청구되지 않습니다.
3. 모델 ID kling-4-0.

export SEEDROUTER_API_KEY="your-key"

Kling 4.0 요청을 어떻게 보냅니까?

/v1/videos/generations에 작업을 POST합니다:

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"
  }'

응답은 동영상이 아닌 작업입니다:

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

model 및 대부분의 모드에서 prompt를 제외한 모든 필드에는 기본값이 있습니다:

사운드 스위치가 없습니다: 모든 Kling 4.0 클립은 스테레오 트랙과 함께 제공됩니다. mode, negative_prompt 또는 watermark 필드도 없습니다. 스키마는 엄격하므로 알 수 없는 필드는 작업이 생성되기 전에 HTTP 400으로 거부되고 오타는 설정이 자동으로 무시된 상태로 유료 클립이 되지 않습니다.

동영상을 어떻게 얻습니까?

status가 completed 또는 failed일 때까지 10~20초마다 GET /v1/tasks/{id}를 폴링합니다. 테스트 실행 5개는 3초 720p 클립의 경우 2분 41초에서 4분 22초 사이가 걸렸으므로 초가 아닌 분 단위로 계획합니다.

import os
import time
import requests

API = "https://api.seedrouter.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"}

task = requests.post(
    f"{API}/videos/generations",
    headers=HEADERS,
    json={
        "model": "kling-4-0",
        "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, no text, no logos.",
        "duration": 5,
    },
    timeout=60,
)
task.raise_for_status()
task_id = task.json()["id"]

while True:
    result = requests.get(f"{API}/tasks/{task_id}", headers=HEADERS, timeout=60).json()
    if result["status"] in ("completed", "failed"):
        break
    time.sleep(15)

if result["status"] == "completed":
    print(result["output"]["video_url"])
else:
    print(result["error"])

완료된 작업은 다음과 같습니다:

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

이것은 이 페이지의 첫 번째 요청이 생성한 클립입니다, 720p의 5초:

Kling 4.0, 텍스트로 동영상, 720p, 5초, 스테레오 사운드 포함.

720p 클립은 1280 × 720에서 스테레오 AAC 트랙이 있는 MP4(H.264)로 반환되었습니다. 파일을 자신의 저장소에 다운로드합니다: 호스팅된 링크는 영구적이지 않습니다. 폴링 중 네트워크 시간 초과는 생성이 실패했다는 의미가 아니므로 작업 ID를 유지하고 새 작업을 제출하는 대신 다시 확인합니다.

Kling 4.0 요청이 어느 모드에서 실행됩니까?

본문의 미디어가 모드를 선택합니다. omni_reference_task_type은 미디어 하나가 모호한 곳에서 명확하게 합니다:

프레임 및 참고 미디어는 하나의 요청으로 혼합될 수 없으며, edit 또는 extend 없는 video_url은 거부됩니다. 둘 다 작업이 존재하기 전에 HTTP 400으로 반환됩니다.

Kling 4.0에서 키프레임을 어떻게 고정합니까?

image_with_roles를 보냅니다, {url, role} 개체 목록. 정확히 하나의 first_frame, 선택적 last_frame 및 최대 8개 keyframe 항목, 총 10개 이미지. 키프레임은 나열한 순서로 사용되므로 목록이 타임라인입니다.

{
  "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
}

시작과 끝만 위해, image_urls: [first, last]가 더 짧습니다. 이미지로 동영상은 prompt를 생략할 수 있는 유일한 모드입니다; 클립은 첫 프레임의 형태를 가집니다.

이미지, 동영상 및 오디오 참고를 어떻게 사용합니까?

video_urls (최대 5개 클립, 총 30초 사용), audio_urls (각각 5~30초 길이의 최대 3개 클립) 및 참고 이미지를 추가합니다, 총 최대 15개 파일. 프롬프트에서 @Image1, @Video1 및 @Audio1로 언급하고, 각 목록에서 1부터 번호를 매깁니다:

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

참고 이미지는 image_urls로도 갈 수 있지만, omni_reference_task_type: "reference"와만 함께; 없이, image_urls는 첫 프레임과 마지막 프레임으로 읽혀집니다. 참고 동영상 자체 사운드는 기본값으로 대체됩니다; audio_setting: "origin"을 설정하여 유지합니다.

Kling 4.0으로 동영상을 어떻게 편집합니까?

omni_reference_task_type을 edit로 설정하고, video_url의 동영상을 전달하고, 변경을 설명합니다. 최대 10개 참고 이미지가 image_urls로 들어갈 수 있습니다.

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

입력은 최소 3초 길이여야 하며, 처음 30초만 사용됩니다. duration을 생략하고 결과는 입력 동영상의 길이를 따릅니다; 원본 사운드는 audio_setting: "auto"를 설정하지 않는 한 유지됩니다.

동영상을 어떻게 연장합니까?

omni_reference_task_type을 extend로 설정하고, 동영상을 전달하고, duration을 새 부분의 길이로 제공합니다. Kling 4.0은 마지막 프레임에서 계속되고 원본 + 새 초를 하나의 파일로 반환합니다. 테스트에서 5.2초 클립을 3초 연장한 것은 8.1초 길이로 반환되었습니다.

{
  "model": "kling-4-0",
  "prompt": "The sailboat keeps gliding forward as the sun sets below the horizon",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 3
}

새 부분이 끝나는 위치를 선택하려면 last_frame_image를 추가합니다. 연장은 입력의 비율과 사운드를 유지하므로 aspect_ratio 및 audio_setting은 거부됩니다.

Kling 4.0 요청은 얼마나 비용이 듭니까?

Kling 4.0은 해상도로 정해진 요율로 동영상 초 단위로 청구됩니다. 계산되는 초는 모드에 따라 다릅니다:

입력은 입력 동영상의 합계 길이이며, 전체 초로 반올림되고 30초로 한정됩니다. 요청이 수락될 때 측정되므로 예약된 금액은 청구된 금액입니다. 편집 테스트에서 5.2초 입력과 3초 결과는 3 + 6 = 9초를 청구했습니다. 이것이 현재 요율입니다:

길이를 읽을 수 없는 동영상은 아무것도 청구되기 전에 거부되며, 실패한 작업은 청구되지 않습니다.

어떤 요청이 아무것도 청구되기 전에 거부됩니까?

이것들은 제출에서 HTTP 400으로 반환되며, 작업이 생성되지 않고 아무것도 청구되지 않습니다:

수락된 후 실패한 작업, 예를 들어 모델의 콘텐츠 정책에서 status: "failed"를 반환하고 error 코드가 있으며 청구되지 않습니다. 오류 카탈로그에는 코드가 나열됩니다.

코딩 에이전트가 할 수 있습니까?

예. Kling 4.0 페이지에는 Claude Code, Codex 또는 Cursor용 준비된 프롬프트가 있으며, 환경에서 키를 읽고, 요청 및 비용을 표시하고, 승인을 기다린 다음 제출하고, 폴링하고, 클립을 다운로드합니다. 동일한 페이지에는 코드가 보낼 정확한 본문을 모드별로 그룹화된 모든 필드와 함께 보내는 Playground가 있습니다.

Kling 4.0 API 질문

Kling 4.0 API는 무료입니까?

아닙니다. 동영상 초 단위로 유료입니다. 새 SeedRouter 계정은 시도할 수 있는 작은 크레딧을 받으며, 구독이 없고, 실패한 작업은 청구되지 않습니다.

Kling 4.0 Flash가 API에 있습니까?

아직 없습니다. Kling 4.0 Flash는 동일한 패밀리의 별도의 가벼운 모델입니다; Kling은 더 짧은 720p 클립 및 여러 키프레임 없이 나열합니다.^[1] kling-4-0 모델 ID는 전체 Kling 4.0입니다.

Kling 4.0은 API에서 Kling 3.0과 어떻게 다릅니까?

Kling 4.0은 최대 30초 클립을 만들고, 키프레임, 동영상 및 오디오 참고를 가져오고, 동영상을 편집하거나 연장할 수 있습니다; 사운드는 항상 켜져 있습니다. Kling 3.0은 3~15초 클립을 만들고, 4K, 멀티샷 프롬프트 및 명명된 요소를 제공하고, 사운드 스위치가 있습니다. Kling 3.0 API 가이드는 해당 필드를 포함합니다. Kling은 2026년 9월 30일에 4.0을 30초 길이, 10개 키프레임 및 스테레오 사운드로 발표했습니다.^[2]

작업을 취소할 수 있습니까?

아닙니다. 수락되면, 작업은 완료 또는 실패까지 실행됩니다. 실패한 작업은 청구되지 않습니다.

참고

1. Kling AI. Kling 4.0 video generation (기능 개요 및 FAQ). kling.ai에서 2026년 10월 8일 확인됨.
2. Kling AI. Introducing Kling 4.0: Visual Realism, Creative Control, and Next-Level Storytelling. 2026년 9월 30일. kling.ai에서 2026년 10월 8일 확인됨.