Kling 4.0 Flash API 가이드: 세 가지 모드, 초당 $0.1225 및 호출 예시

Kling 4.0 Flash란

Kling 4.0 Flash는 Kling 4.0의 고속 버전 비디오 모델로, HiAPI에서는 세 가지 입력 방식에 대응하는 세 개의 모델 ID로 나뉩니다:

• kling-4.0-flash/text-to-video: 프롬프트만 작성하여 비디오를 생성합니다.
• kling-4.0-flash/image-to-video: 첫 프레임 이미지를 제공한 뒤 프롬프트로 동작과 카메라 무빙을 설명합니다.
• kling-4.0-flash/reference-to-video: 1–10장의 참조 이미지를 제공하고 프롬프트에서 @Image1, @Image2로 지칭하여 인물, 상품 또는 스타일을 비디오에서 일관되게 유지합니다.

세 모델의 공통점: 720p 출력, 길이 3–20초(정수 초, 기본 5초), 화면과 네이티브 오디오를 함께 생성하므로 별도로 오디오 트랙을 추가할 필요가 없습니다.

가격: 초당 $0.1225, 세 모드 동일 가격

출력 길이 기준으로 과금되며 초당 $0.1225이고, 오디오는 추가 요금이 없으며 참조 이미지도 추가 요금이 없습니다. 자주 쓰는 길이로 계산해 보면:

• 5초(기본): $0.6125
• 10초: $1.225
• 20초(상한): $2.45

비용은 duration에만 관련되므로, 먼저 3–5초로 프롬프트와 구도를 시험한 뒤 확정되면 늘리는 것이 가장 직접적인 절약 방법입니다. 작업이 실패하면 전액 환불됩니다.

파라미터

세 모델은 prompt, duration, resolution을 공유하며, 차이는 이미지 입력과 화면 비율에 있습니다:

• prompt: 최대 2500자. 텍스트-투-비디오와 레퍼런스-투-비디오에서는 필수이고, 이미지-투-비디오에서는 생략할 수 있지만 동작과 카메라 무빙을 작성하면 더 제어하기 쉽습니다.
• duration: 3–20의 정수, 기본 5.
• resolution: 현재 720p만 지원합니다.
• aspect_ratio: 텍스트-투-비디오는 16:9(기본), 9:16, 1:1, 21:9 중 선택 가능하며, 레퍼런스-투-비디오는 이 네 가지 외에 auto(기본)가 있습니다. 이미지-투-비디오에는 이 파라미터가 없으며 화면 비율은 첫 프레임 이미지를 따릅니다.
• image_urls: 이미지-투-비디오는 필수이며 1장만 가능하고, 레퍼런스-투-비디오는 1–10장, 텍스트-투-비디오는 필요 없습니다.

요청 예시

HiAPI의 비디오 작업은 비동기 방식입니다: 먼저 작업을 생성한 뒤 결과를 폴링합니다. model은 최상위에 두고 나머지 파라미터는 input에 넣습니다.

텍스트-투-비디오, 세로 화면 8초:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4.0-flash/text-to-video",
    "input": {
      "prompt": "비 오는 밤 네온사인이 빛나는 거리 모퉁이, 투명 우산을 쓴 소녀가 카메라를 돌아보고, 카메라가 천천히 다가가며, 빗소리와 멀리서 들리는 차량 소리",
      "aspect_ratio": "9:16",
      "duration": 8
    }
  }'

이 주문은 8 × $0.1225 = $0.98입니다.

레퍼런스-투-비디오, 두 장의 이미지로 인물과 상품을 고정:

{
  "model": "kling-4.0-flash/reference-to-video",
  "input": {
    "prompt": "@Image1의 여성이 카페 창가에서 @Image2의 보온병을 집어 들고 카메라를 향해 미소 짓는다, 자연광",
    "image_urls": [
      "https://example.com/model.jpg",
      "https://example.com/bottle.jpg"
    ],
    "aspect_ratio": "16:9",
    "duration": 5
  }
}

생성에 성공하면 반환된 작업 ID로 GET https://api.hiapi.ai/v1/tasks/{taskId}를 호출해 폴링하고, 성공하면 출력에서 비디오 주소를 가져옵니다.

세 가지 모드 선택 방법

• 아이디어만 있고 소재가 없을 때: 텍스트-투-비디오를 사용하며, 방향을 찾거나 스토리보드 사전 시각화에 적합합니다.
• 이미 정해진 화면이 있을 때(포스터, 상품 대표 이미지, 캐릭터 설정 이미지): 이미지-투-비디오를 사용하며, 구도와 색감은 첫 프레임을 따르고 프롬프트에는 어떻게 움직일지만 작성합니다.
• 같은 인물이나 같은 상품이 서로 다른 장면에 등장해야 할 때: 레퍼런스-투-비디오를 사용하며, 각 이미지를 프롬프트에서 @ImageN으로 지칭하고 화면에서 무엇을 하는지 명확히 설명합니다.

현재 제한 사항

• 720p만 지원하며 1080p 옵션은 없습니다.
• 1회 최대 20초이며, 더 긴 완성본은 분할 생성 후 편집해야 합니다.
• 이미지는 공인터넷에서 접근 가능한 http(s) 주소여야 하며, JPEG 또는 PNG, 양쪽 최소 300px, 화면 비율은 2:5에서 5:2 사이여야 합니다.
• 오디오는 화면과 함께 생성되며 끄는 스위치가 없습니다. 원하는 소리(환경음, 효과음, 분위기)는 프롬프트에 직접 작성하세요.