사용 가이드

클링 4.0 API는 언제 사용할 수 있나? 공식 발표 내용과 현재 사용 가능한 모델

클링 4.0은 9월 28일에 출시되었지만 아직 공개 API는 없습니다. 공식 발표된 기능, 출시 일정, 그리고 지금 클링 3.0으로 먼저 작업하는 방법을 정리했습니다.

Oct 15, 2026

결론부터: 클링 4.0(Kling 4.0)은 현재 공개 API가 없습니다. 콰이쇼우는 2026년 9월 28일에 클링 4.0을 발표했고, 보도에 따르면 정식 버전은 2026년 10월 출시 예정이지만 구체적인 날짜는 공개되지 않았습니다. 지금 사용 가능한 것은 클링 자사 제품 내에서 소규모로 공개된 Flash 버전뿐이며, API도 없고 가격도 발표되지 않았습니다. HiAPI에는 이미 클링 4.0 예고 페이지가 있어 출시 알림을 등록할 수 있습니다.

그 전까지 호출할 수 있는 것은 클링 3.0입니다. 아래 코드는 모델명을 설정 항목으로 만들어 두었기 때문에, 나중에 4.0으로 바꿀 때 모델명 하나만 수정하면 됩니다.

공식 발표 내용

발표 당시 보도(SlopTV, GuruFocus)를 종합하면:

항목	공식 발표	현재 사용 가능
단일 영상 길이	최대 30초	Flash: 3–20초
키프레임	최대 10장	아직 사용 불가
멀티모달 레퍼런스	회당 최대 15개	아직 사용 불가
해상도	최대 4K	Flash: 최대 720p
출시 일정	정식 버전 2026년 10월, 구체적 날짜 미정	Flash는 9월 28일부터 소규모 공개
API 및 가격	미발표	없음

위 내용은 공식 발표된 수치이며, 저희가 직접 측정한 것이 아닙니다. 클링 4.0을 HiAPI에서 호출할 수 있게 되면 이 페이지를 업데이트하겠습니다.

현재 사용 가능한 모델: 클링 3.0

HiAPI의 클링 3.0은 세 가지 라인이 있으며, 모두 동일한 POST /v1/tasks 인터페이스를 사용합니다:

모델	입력 방식	720p / 초	1080p / 초	4K / 초
클링 3.0 `kling-3.0/*`	텍스트→영상, 이미지→영상(첫 프레임 또는 첫·끝 프레임)	$0.10, 사운드 켜면 $0.143	$0.129, 사운드 켜면 $0.193	$0.479
클링 3.0 Omni `kling-3.0-omni/*`	텍스트→영상, 이미지→영상, 레퍼런스→영상, 영상 재작성	$0.10, 사운드 켜면 $0.129	$0.129, 사운드 켜면 $0.1645	$0.479
클링 3.0 Turbo `kling-3.0-turbo/*`	텍스트→영상, 이미지→영상	$0.13	$0.16	—

HiAPI 현재 가격, 2026년 10월 15일 기준 확인, 실패 시 과금 없음.

모델 페이지의 클링 3.0 예시, 5초:

A lone red fox sprints across a windswept snowy ridge at golden hour, powder snow kicking up behind each stride, then leaps over a frozen creek in a graceful arc. Cinematic, dramatic side lighting, ultra-detailed fur, shallow depth of field, smooth motion.

이 프롬프트로 생성하기 →(5초, 16:9)

kling-3.0/text-to-video 모델 페이지 예시, 5초. 720p 사운드 끔 기준 $0.50.

나중에 4.0으로 바로 전환할 수 있는 코드 작성

모델명을 설정에 넣으면 요청 형식은 바꿀 필요가 없습니다. HiAPI의 모든 영상 모델은 동일한 작업 인터페이스를 사용하므로, 모델 교체는 보통 설정만 바꾸고 새 모델에 추가된 파라미터를 보충하면 됩니다.

import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}
KLING_MODEL = os.environ.get("KLING_MODEL", "kling-3.0/text-to-video")  # 나중에 여기서 전환


def generate(prompt: str, **params) -> str:
    r = requests.post(API, json={"model": KLING_MODEL, "input": {"prompt": prompt, **params}},
                      headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    while True:
        data = requests.get(f"{API}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
        if data["status"] == "success":
            return data["output"][0]["url"]
        if data["status"] == "fail":
            raise RuntimeError(data.get("error"))
        time.sleep(10)


print(generate("金色夕阳下，一只红狐在雪脊上疾奔，平滑跟拍",
               duration=5, resolution="720p", aspect_ratio="16:9", sound=False))

전체 파라미터, 이미지→영상, 오류 처리에 대해서는 클링 3.0 API 한국어 튜토리얼을 참고하세요.

4.0을 기다리는 동안 클링 3.0 선택 가이드

대사, 음향 효과, 멀티샷 또는 4K가 필요하다면: kling-3.0을 사용하세요. 작성법은 클링 3.0 프롬프트 가이드를 참고하세요.
레퍼런스 이미지로 인물이나 상품을 고정하거나, 레퍼런스 영상의 카메라 무빙을 따라가야 한다면: kling-3.0-omni를 사용하세요. 클링 3.0 Omni 한국어 튜토리얼을 참고하세요.
첫 프레임 한 장만 있고, 간단한 통일 가격과 기본 사운드면 충분하다면: kling-3.0-turbo를 사용하세요.