guides

Kling 4.0 Flash API 가이드: 파라미터, 가격, 코드

Poyo.ai Team
11 min read
Share:

핵심 요약

  • Kling 4.0 Flash는 Kling 4.0의 빠르고 저렴한 등급입니다. 텍스트, 시작 이미지, 참조로 720p의 3–20초 클립을 만들고, 기존 동영상도 편집합니다.
  • 모델 ID 하나로 모든 모드를 씁니다. POST /api/generate/submit에 "model": "kling-4.0-flash"를 보내세요. 함께 넣는 미디어에 따라 텍스트→동영상, 이미지→동영상, 참조→동영상, 편집이 정해집니다.
  • PoYo에서는 출력 1초당 $0.094입니다(18.8크레딧). 텍스트, 이미지, 이미지 참조 작업 기준이며, 5초 클립은 $0.47, 10초 클립은 $0.94입니다. 동영상을 입력으로 쓰면 청구 1초당 $0.063입니다.
  • 키 하나로 사용한 만큼 결제합니다. PoYo는 구독 없이 사용한 만큼 크레딧으로 Flash를 청구하며, 같은 키와 요청 형식으로 Kling 4.0, Gemini Omni, Veo도 실행합니다.
  • 결과는 비동기로 받습니다. task_id를 저장한 뒤 GET /api/generate/status/{task_id}를 폴링하거나 callback_url을 설정하세요.
  • Kling 4.0으로 바꾸려면 한 단어만 바꾸면 됩니다. 두 모델은 같은 요청 필드를 공유하며, Kling 4.0은 1080p, 30초 클립, 끝 프레임, 멀티숏 프롬프트를 추가로 지원합니다.

Kling 4.0 Flash 한눈에 보기

PoYo의 Kling 4.0 Flash
개발사Kuaishou(Kling AI)
API 모델 IDkling-4.0-flash
모델 페이지/ko/models/kling-4-0-flash
모드텍스트→동영상, 이미지→동영상(시작 프레임 1장), 참조→동영상, 동영상 편집
클립 길이3–20초, 정수 초, 기본값 5
해상도720p(Kling 기준 8비트 SDR)
화면비16:9(기본값), 9:16, 1:1, 21:9, auto
참조이미지 최대 10장, 동영상 5개, 주체 7개, 총 15개
입력 동영상 한도원본, 참조, 주체 동영상을 모두 합쳐 최대 20초
프롬프트 길이최대 26,000자
가격$0.094/초 · 동영상 입력 시 청구 1초당 $0.063

Kling 4.0 Flash란?

Kling 4.0 Flash는 Kuaishou의 Kling 4.0 동영상 제품군 중 속도에 초점을 맞춘 모델입니다. Kling의 자체 가이드는 이 모델을 잦은 제작을 위해 "빠른 생성과 뛰어난 가성비"를 결합한 모델로 소개하며, 텍스트→동영상, 이미지→동영상, Omni Reference를 갖춘 720p 3–20초 클립을 안내합니다. 정식 Kling 4.0 모델은 PoYo에서 최대 30초와 1080p를 지원하고, 시작·끝 프레임과 멀티숏 프롬프트를 추가로 제공합니다.

"Kling 4 Flash"와 "Kling 4.0 Flash"는 같은 모델입니다. PoYo에서 페이지 슬러그는 kling-4-0-flash이고, API 모델 ID는 점이 들어간 kling-4.0-flash입니다.

최대 해상도보다 생산량과 처리 속도가 중요한 곳에 Flash를 쓰세요. SNS 클립, 훅과 포맷 테스트, 제품 루프 영상, 프리비즈, 최종 렌더링 전 초안 단계에 잘 맞습니다.

720p Kling 4.0 Flash 클립: 햇살이 드는 나무 도장에서 대련하는 두 무술가. PoYo 모델 페이지의 예시입니다.

모델 ID 하나, 네 가지 모드

PoYo는 input 안의 필드를 보고 모드를 정합니다.

모드보낼 필드참고
텍스트→동영상promptaspect_ratio 선택
이미지→동영상이미지 정확히 1장을 담은 image_urlsprompt는 선택, 시작 이미지가 화면 구성을 정함
참조→동영상reference_image_urls, reference_video_urls 및/또는 kling_elementsimage_urls의 선택형 시작 프레임은 이미지 10장 한도에 포함
동영상 편집video_url + prompt참조 이미지, 최대 4개 참조 동영상과 주체 추가 가능, 화면 구성은 원본 동영상을 따름

우선순위는 고정되어 있습니다. video_url이 있으면 편집, 참조 필드가 하나라도 있으면 참조→동영상, image_urls만 있으면 이미지→동영상, 프롬프트만 있으면 텍스트→동영상입니다.

요청 파라미터

model과 callback_url은 최상위에 두고, 나머지 필드는 모두 input 안에 넣습니다.

필드타입값과 한도기본값
modelstringkling-4.0-flash필수
callback_urlstring작업이 완료되거나 실패하면 POST를 받는 공개 URL—
promptstring1–26,000자, 텍스트·참조·편집에서 필수, 이미지→동영상에서는 선택—
durationinteger3–205, 편집 시 원본 길이
resolutionstring720p720p
aspect_ratiostringauto, 16:9, 9:16, 1:1, 21:9(텍스트·참조 모드)16:9
image_urlsarray시작 이미지 정확히 1장—
reference_image_urlsarray이미지 최대 10장—
reference_video_urlsarray동영상 최대 5개(편집 시 4개), 각 3–20초—
kling_elementsarray주체 최대 7개, 각각 element_input_urls(이미지 2–4장, 정면 사진 먼저) 또는 element_input_video_urls(3–8초 동영상 정확히 1개) 중 하나, 동영상 주체는 최대 3개—
video_urlstring편집할 원본 동영상, 3–20초—

제출 전에 확인할 공통 한도:

  • 총 15개: 시작 프레임 + 참조 이미지 + 참조 동영상 + 주체.
  • 입력 동영상 총 20초: 원본 동영상 + 참조 동영상 + 동영상 주체.
  • 태그는 배열 순서를 따릅니다: @Image1, @Video1, @Element1. 편집 시에는 원본 동영상이 @Video1이고 참조 동영상은 @Video2부터 시작합니다.
  • Playground 업로드 형식: MP4 또는 MOV, 동영상당 최대 200 MB. 미디어 URL은 공개 HTTP 또는 HTTPS 링크를 사용합니다.

첫 요청 제출하기

PoYo 대시보드에서 API 키를 만들어 서버에 보관하세요. 그다음 5초 텍스트→동영상 작업을 제출합니다.

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4.0-flash",
    "input": {
      "prompt": "A ceramic mug of coffee steams on a wooden windowsill as rain streaks the glass. Slow push-in, soft morning light, clean frame free of text and logos.",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

제출에 성공하면 code: 200과 함께 data에 작업 정보가 반환됩니다.

{
  "code": 200,
  "data": {
    "task_id": "YOUR_TASK_ID",
    "status": "not_started",
    "created_time": "2026-11-14T10:30:00"
  }
}

유효성 검사 오류도 HTTP 200과 code: 400으로 돌아올 수 있으므로, HTTP 상태와 함께 code 필드도 확인하세요. 402는 계정에 크레딧 충전이 필요하다는 뜻입니다.

추가 요청 예시

시작 프레임 1장으로 이미지→동영상

{
  "model": "kling-4.0-flash",
  "input": {
    "image_urls": ["https://example.com/red-panda.png"],
    "prompt": "The red panda shakes the snow off its fur, then turns toward the camera. Slow push-in, shallow depth of field.",
    "duration": 5
  }
}

이미지→동영상 결과: 눈 덮인 대나무 가지 위의 레서판다가 눈을 털어 내고 카메라 쪽으로 돌아봅니다. 5초, 94크레딧. PoYo 모델 페이지의 예시입니다.

주체를 활용한 참조→동영상

아래 주체는 정면 사진과 측면 사진을 씁니다. 프롬프트는 이 주체를 @Element1로, 장소 이미지를 @Image1로 지칭합니다.

{
  "model": "kling-4.0-flash",
  "input": {
    "prompt": "@Element1 walks along the cliff-top path toward the lighthouse in @Image1 at golden hour. The camera tracks beside him as he stops and looks up at the lamp. Keep his face and yellow raincoat consistent with @Element1.",
    "reference_image_urls": ["https://example.com/lighthouse.png"],
    "kling_elements": [
      {
        "element_input_urls": [
          "https://example.com/keeper-front.png",
          "https://example.com/keeper-side.png"
        ]
      }
    ],
    "duration": 8,
    "aspect_ratio": "9:16"
  }
}

참조→동영상 결과: 장소 이미지 한 장과 두 방향 사진으로 만든 주체를 바탕으로, 노란 우비와 빨간 비니 차림의 등대지기가 골든아워에 절벽 길을 따라 등대로 걸어갑니다. 8초, 9:16, 150.4크레딧. PoYo 모델 페이지의 예시입니다.

기존 클립 편집

출력은 기본적으로 원본 길이를 유지합니다.

{
  "model": "kling-4.0-flash",
  "input": {
    "video_url": "https://example.com/winter-clip.mp4",
    "reference_image_urls": ["https://example.com/spring-bamboo.png"],
    "prompt": "Edit @Video1 and change the season from winter to spring, using @Image1 as the environment reference. Keep the animal, its movements, timing and camera motion exactly as in @Video1."
  }
}

편집 결과: 위의 눈 속 레서판다 클립을 초록 대나무와 벚꽃이 있는 봄으로 바꾸면서, 판다의 움직임과 카메라 움직임은 그대로 유지했습니다. 151.2크레딧. PoYo 모델 페이지의 예시입니다.

작업 상태 폴링

작업 ID로 언제든 작업을 확인할 수 있습니다.

curl https://api.poyo.ai/api/generate/status/YOUR_TASK_ID \
  -H "Authorization: Bearer $POYO_API_KEY"

상태는 not_started에서 running을 거쳐 finished 또는 failed가 됩니다. 완료된 작업은 data.files에 file_url과 file_type: "video"로 동영상을 담아 보여 주고, 실패한 작업에는 error_message가 있습니다.

백엔드용 시간 제한 Python 루프:

import os
import time
import requests

API = "https://api.poyo.ai"
HEADERS = {"Authorization": "Bearer " + os.environ["POYO_API_KEY"]}

def data_or_raise(resp):
    resp.raise_for_status()
    body = resp.json()
    if body.get("code") not in (0, 200):
        raise RuntimeError(body.get("message") or body)
    return body["data"]

task = data_or_raise(requests.post(f"{API}/api/generate/submit", headers=HEADERS, json={
    "model": "kling-4.0-flash",
    "input": {
        "prompt": "A paper lantern drifts up over a night market. Slow tilt up, warm light, glowing stalls below.",
        "duration": 5,
        "aspect_ratio": "9:16",
    },
}, timeout=60))
task_id = task["task_id"]
print("task:", task_id)

deadline = time.monotonic() + 20 * 60
while time.monotonic() < deadline:
    status = data_or_raise(requests.get(f"{API}/api/generate/status/{task_id}", headers=HEADERS, timeout=60))
    if status["status"] == "finished":
        print([f["file_url"] for f in status.get("files", []) if f.get("file_type") == "video"])
        break
    if status["status"] == "failed":
        raise RuntimeError(status.get("error_message") or "generation failed")
    time.sleep(10)
else:
    print("Still running; check this task_id again later:", task_id)

루프가 시간 제한에 걸리면 나중에 같은 task_id로 다시 조회하세요. 새로 제출할 때마다 별도의 클립으로 청구됩니다. 프로덕션 파이프라인에서는 최상위 callback_url을 쓰면 폴링 대신 웹훅으로 결과를 받을 수 있습니다.

Kling 4.0 Flash 클립당 비용

PoYo는 Flash를 사용한 만큼 내는 크레딧($1 = 200크레딧)으로 초 단위 청구합니다. 텍스트, 이미지, 이미지 참조 작업은 출력 길이에 단일 요율을 적용하며, 참조 이미지와 이미지 주체가 포함됩니다.

출력 길이크레딧USD
3초56.4$0.282
5초94$0.47
8초150.4$0.752
10초188$0.94
15초282$1.41
20초376$1.88

비교하자면 같은 5초 클립이 720p Kling 4.0에서는 $0.7125이므로, Flash가 약 34% 저렴합니다.

동영상을 입력으로 쓸 때

요청에 원본 동영상, 참조 동영상, 동영상 주체가 들어가면 요율은 청구 1초당 12.6크레딧($0.063)이며, 청구 초는 다음과 같이 계산합니다.

청구 초 = 출력 길이 + max(올림한 입력 동영상 총길이, 출력 길이)

작업청구 초크레딧USD
4초 참조 동영상 1개로 안내한 5초 클립5 + max(4, 5) = 10126$0.63
참조 동영상 12초로 안내한 10초 클립10 + max(12, 10) = 22277.2$1.386
8초 클립 편집, 길이 유지8 + max(8, 8) = 16201.6$1.008
5초 참조 동영상 1개로 15초 클립 편집15 + max(20, 15) = 35441$2.205

입력 길이의 소수점은 올림합니다. 모델 페이지의 봄 편집 예시는 5초를 조금 넘는 원본을 써서 6초로 계산되었고, 6 + 6 = 12 청구 초, 즉 151.2크레딧이었습니다. Kling 4.0 제품군 전체의 예산은 Kling 4.0 API 가격 가이드를 참고하세요.

Kling 4.0 Flash 프롬프트 팁

  1. 클립 하나에 연속된 동작 하나. 짧은 클립은 프롬프트가 피사체 하나의 한 장면을 따라갈 때 가장 안정적입니다. "돌아서고, 멈추고, 올려다본다"처럼요. 여러 장면이 있는 이야기는 10–20초 클립에서 도입, 전개, 마무리 순서로 쓰세요.
  2. 카메라 움직임을 명시하세요. 푸시인, 오빗, 트래킹 숏, 틸트 업 등. 시각적 세부 묘사와 구분되도록 별도 문장으로 쓰세요.
  3. 빛과 질감을 묘사하세요. 시간대, 빛의 방향, 젖은 유리·헤어라인 금속·털 같은 재질을 적으면 720p 클립의 인상이 선명하고 일관됩니다.
  4. 모든 입력에 태그를 다세요. 미디어는 배열 순서대로 @Image1, @Video1, @Element1로 지칭하고, 각각이 무엇(인물, 장소, 움직임, 스타일)을 제어하는지 적으세요.
  5. 주체는 신중하게 구성하세요. 정면 사진을 맨 앞에 두고 다른 각도 1–3장을 더하며, 배경은 단순하게 유지하세요. 동영상 주체에는 선명한 3–8초 클립 하나를 쓰세요.
  6. 편집은 "Edit @Video1"로 시작하세요. 그다음 바꿀 내용을 적고, 그대로 유지할 것(인물, 움직임, 타이밍, 카메라 경로)을 나열하세요.
  7. 깔끔한 화면을 요청하세요. 나중에 자막이나 브랜딩을 넣을 계획이라면 "clean frame, free of text and logos"(텍스트와 로고 없는 깔끔한 화면)를 추가하세요.
  8. 아이디어에 맞게 길이를 정하세요. 5초 클립은 제스처나 공개 장면 하나에 맞습니다. 비용이 초마다 늘어나므로 15–20초는 여유가 필요한 동작에만 쓰세요.

Kling 4.0 Flash의 카메라 연출: 네온 조명 아래 연기 속을 드리프트하는 경주용 차 주위를 카메라가 돌다가 차 앞에서 멈춥니다. PoYo 모델 페이지의 예시입니다.

제품군 전반에 통하는 프롬프트 패턴은 Kling 4.0 프롬프트 가이드와 Omni Reference 가이드를 참고하세요.

Kling 4.0 Flash vs Kling 4.0 요약

Kling 4.0 FlashKling 4.0
모델 IDkling-4.0-flashkling-4.0
해상도720p720p, 1080p
클립 길이3–20초3–30초
프레임시작 프레임 1장시작 프레임과 끝 프레임
멀티숏 프롬프트클립당 프롬프트 1개숏별 길이를 지정하는 multi_prompt
편집 참조이미지, 최대 4개 참조 동영상과 주체이미지와 이미지 주체
720p 가격, 텍스트·이미지 작업$0.094/초$0.1425/초

Flash로 초안을 만들고, 최종 컷에 1080p, 끝 프레임, 20초 초과가 필요할 때 선택한 방향을 Kling 4.0으로 옮기세요. 전체 비교는 Kling 4.0 vs Flash를 읽어 보세요. Flash를 Google의 고속 동영상 모델과 비교하려면 Gemini Omni 1.2 Flash vs Kling 4.0 Flash vs Veo 3.1을 읽어 보세요.

자주 묻는 질문

Kling 4.0 Flash의 모델 ID는 무엇인가요?

kling-4.0-flash입니다. 페이지 슬러그 kling-4-0-flash는 URL에 쓰입니다. 요청 본문에는 "model": "kling-4.0-flash"를 보내세요.

Kling 4.0 Flash는 얼마인가요?

PoYo에서 텍스트, 이미지, 이미지 참조 작업은 출력 1초당 18.8크레딧($0.094)입니다. 5초는 $0.47, 10초는 $0.94, 20초는 $1.88입니다. 동영상을 입력으로 쓰면 청구 1초당 12.6크레딧($0.063)입니다.

Kling 4 Flash는 무료인가요?

Kling 4.0 Flash는 PoYo에서 구독 없이 사용한 만큼 내는 크레딧으로 실행됩니다. 실행할 때마다 크레딧 잔액에서 차감되며, Playground에서 생성 전에 크레딧 예상치를 보여 주므로 프롬프트, 참조 세트, 편집의 비용을 먼저 확인할 수 있습니다.

Kling 4.0 Flash 동영상은 얼마나 길게 만들 수 있나요?

생성당 3–20초이며, 정수 초 단위입니다. 기본값은 5초이고, 편집은 duration을 설정하지 않으면 원본 길이를 유지합니다.

언제 Flash에서 Kling 4.0으로 옮겨야 하나요?

Flash는 프롬프트, 시작 프레임, 참조로 만드는 720p 클립에 맞춰 설계되었습니다. 1080p, 끝 프레임, multi_prompt, 최대 30초 클립이 필요하면 같은 요청 필드로 Kling 4.0을 사용하세요.

Kling 4.0 Flash가 Kling 4.0보다 빠른가요?

Kling은 Flash를 잦은 제작과 빠른 반복을 위해 만든 더 빠른 등급으로 소개합니다. 생성 시간은 클립 길이와 현재 부하에 따라 달라지므로, 실제 프롬프트 몇 개로 시간을 재 보세요.

다른 동영상 모델에도 같은 키를 쓸 수 있나요?

네. Kling 4.0 Flash를 실행하는 PoYo 키로 Kling 4.0, Gemini Omni 1.2 Flash, Veo 3.1 등 다른 모델도 같은 제출·상태 엔드포인트와 하나의 크레딧 잔액으로 실행할 수 있습니다.

동영상이 준비되면 웹훅을 받을 수 있나요?

네. 최상위에 callback_url을 추가하면 작업이 완료되거나 실패할 때 PoYo가 해당 URL로 POST를 보냅니다. 같은 task_id로 상태 엔드포인트를 언제든 조회할 수도 있습니다.

Share: