Kling 4.0 Flash

Kling 4.0 Flash는 Kuaishou의 Kling 4.0 제품군에 속하는 경량 모델입니다. SeedRouter에서는 텍스트로 동영상 생성과 레퍼런스 기반 생성을 지원합니다. 최대 10개 레퍼런스 이미지, 최대 5개 레퍼런스 동영상과 최대 7개 엘리먼트(이미지 24개 또는 짧은 동영상 하나로 만든, 이름이 있는 피사체)를 프롬프트에서 각각 언급해 사용합니다. 모든 클립은 사운드가 포함된 720p, 320초 길이입니다. 요청을 보내고, 반환된 작업 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-flash",
    "prompt": "A paper boat drifts down a rain-filled city gutter at dusk, the camera skimming the water beside it past glowing shop windows, raindrops ticking on the surface. No text, no logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

엔드포인트

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

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

파라미터

모든 클립에는 사운드가 포함되며, 사운드 스위치는 없습니다. 첫 프레임, 중간 프레임 또는 마지막 프레임 필드나 negative_prompt, watermark, 독립적인 voices 필드는 없습니다. voice_url로 엘리먼트에 목소리를 연결하세요. 스키마는 엄격합니다. 알 수 없는 필드는 무시되지 않고 거부됩니다. callback_url은 사용할 수 없습니다. 대신 작업을 폴링하세요.

언급

전송할 수 있는 모든 미디어는 선택 사항이며, 아무것도 보내지 않으면 텍스트만으로 동영상을 생성합니다. 미디어를 보냈다면 프롬프트에서 지정하세요:

알파벳, 숫자, 밑줄 또는 한자가 뒤따르는 모든 @는 이 요청에 포함된 미디어를 가리켜야 합니다. 그렇지 않으면 과금 전에 요청이 거부됩니다. 이름은 가장 긴 것부터 대소문자 구분 없이 일치 여부를 확인합니다. 알파벳, 숫자 또는 밑줄로 끝나는 이름 바로 뒤에 같은 종류의 문자가 이어져서는 안 됩니다. 이미지가 하나일 때 @image_12는 거부되므로, @image_1 2 또는 @image_1,로 작성하세요.

레퍼런스 동영상과 동영상 엘리먼트를 합쳐 최대 5개이며, 이미지, 동영상과 엘리먼트를 모두 합쳐 최대 15개입니다.

{
  "model": "kling-4-0-flash",
  "prompt": "The dancer from @image_1 performs the routine of @video_1 on a rooftop at dusk",
  "image_urls": ["https://example.com/dancer.png"],
  "video_urls": ["https://example.com/routine.mp4"],
  "keep_original_sound": false,
  "duration": 8
}

엘리먼트

엘리먼트는 프롬프트에서 재사용할 수 있는, 이름이 있는 피사체입니다. 두 종류가 있습니다:

이름은 알파벳, 숫자, 밑줄 또는 한자로 이루어진 1~20자이며 대소문자를 구분하지 않고 고유해야 합니다. image_N, video_N, keyframe_N, object_N, audio_N, first_frame 및 last_frame은 예약된 이름입니다.

{
  "model": "kling-4-0-flash",
  "prompt": "@Mira opens the shop door and greets the morning crowd",
  "elements": [
    {
      "name": "Mira",
      "image_urls": ["https://example.com/mira-front.png", "https://example.com/mira-side.png"],
      "tag": "character",
      "description": "baker in a flour-dusted apron"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 6
}

미디어 입력

이미지, 동영상 및 오디오는 공개 HTTP(S) URL입니다. Base64 데이터 URI는 허용되지 않습니다: 파일을 자신의 저장소에 업로드하고 해당 URL을 전달합니다. 레퍼런스 동영상과 동영상 엘리먼트의 총길이는 2~20초여야 합니다. 요청이 수락될 때 길이를 읽으며, 길이를 읽을 수 없는 동영상은 과금 전에 거부됩니다.

가격 책정 차원

모델 가격 책정 섹션에서 현재 요율을 확인하세요. Kling 4.0 Flash는 720p 동영상 초 단위로 과금됩니다:

text, reference images, image elements:   cost = duration × standard rate
reference videos or video elements:       cost = (output + max(output, input)) × video-input rate

input은 레퍼런스 동영상과 동영상 엘리먼트의 길이를 합산한 뒤 초 단위로 올림한 값입니다. 요청이 수락될 때 측정되므로 예약된 금액이 청구되는 금액입니다. 예: 7.2초 레퍼런스 동영상을 참고해 5초 클립을 만들면 5 + 8 = 13초가 과금되며, 3초 레퍼런스 동영상이면 5 + 5 = 10초가 과금됩니다. 실패한 작업은 청구되지 않습니다.

출력 스키마

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

{"id": "task_...", "model": "kling-4-0-flash", "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-flash",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689800,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

테스트에서 5초 클립은 제출 후 91~103초 만에 스테레오 AAC 트랙이 있는 1280 × 720 MP4(H.264)로 반환되었습니다. 파일의 재생 길이는 duration보다 약 한 프레임 더 깁니다(5로 설정하면 5.04초).

오류

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

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

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

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

팁

• 피사체, 장소, 카메라 움직임, 빛과 사운드를 설명합니다; 클립의 오디오는 프롬프트를 따릅니다.
• Flash로 프롬프트, 화면비와 레퍼런스를 저렴하게 시험한 뒤, 1080p, 키프레임, 편집 또는 연장이 필요할 때 효과적인 샷을 Kling 4.0으로 옮기세요.
• 반복 등장하는 캐릭터에는 레퍼런스 이미지 하나 대신 선명한 두세 각도의 이미지로 구성된 엘리먼트를 지정하세요.
• no text, no logos를 추가해 임의로 만들어진 표식이 나오지 않도록 하세요.

관련

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