Kling 3.0 Omni API 사용법? 네 가지 엔트리로 5분 만에 실행하기

TL;DR

• Kling 3.0 Omni는 Kling의 만능 비디오 모델로, HiAPI에서 텍스트 투 비디오, 이미지 투 비디오, 레퍼런스 투 비디오, 비디오 변환의 네 가지 엔트리로 제공되며, 모델 페이지 열기에서 온라인으로 생성할 수 있고, 신규 사용자 가입 시 200 크레딧을 제공합니다.
• 초 단위 과금: 720p 초당 $0.10부터, 1080p 초당 $0.129부터, 4K 초당 $0.479; 사운드 켜기, 레퍼런스 비디오 포함 시 별도 단가가 적용됩니다.
• API는 동일한 /v1/tasks 인터페이스를 사용하며 model과 input만 바꾸면 됩니다. 아래 curl과 Python은 복사해서 바로 실행할 수 있습니다.

네 가지 엔트리는 각각 무엇을 하나요?

모델 ID	입력	적합
kling-3.0-omni/text-to-video	프롬프트	제로에서 씬 만들기
kling-3.0-omni/image-to-video	첫 프레임 1장, 또는 첫 프레임 + 마지막 프레임	이미지 한 장을 움직이게 하기
kling-3.0-omni/reference-to-video	레퍼런스 이미지 1–7장, 레퍼런스 비디오 1개 추가 가능	인물, 상품 고정, 또는 레퍼런스 비디오의 카메라 워킹 따라 하기
kling-3.0-omni/transformation	원본 비디오 1개	카메라 워킹과 동작을 유지하고 장면과 스타일 교체

네 가지 엔트리 모두 해상도 720p, 1080p, 4k를 선택할 수 있습니다. 텍스트 생성과 레퍼런스 생성은 길이(3–15초), 화면 비율(16:9, 9:16, 1:1)과 사운드(audio)를 설정할 수 있고, 이미지 생성은 길이와 사운드를 설정할 수 있으며 화면 비율은 첫 프레임을 따릅니다. 비디오 변환은 프롬프트, 원본 비디오, 해상도만 전달하며 길이와 화면 비율은 원본 비디오를 따르고 사운드는 생성하지 않습니다. 텍스트 생성, 이미지 생성, 레퍼런스 생성은 스마트 멀티 샷(prefer_multi_shots)도 지원하며, 네 가지 엔트리 모두 재사용 가능한 주체(elements, 프롬프트에 @이름 작성)를 사용할 수 있습니다.

아래 3초 720p의 비 내리는 밤 종이배는 한 줄 프롬프트로 바로 생성한 것입니다:

A paper boat drifts down a rain-soaked city gutter at dusk, neon signs reflecting and rippling on the water; the camera glides low beside it as raindrops splash around. Cinematic, shallow depth of field, smooth tracking motion.

이 프롬프트로 생성 →

두 가지 시작 경로

온라인 체험(코딩 없음)

1. 해당 모델 페이지(예: 텍스트 투 비디오)를 열고 가입하거나 로그인합니다.
2. 프롬프트를 붙여넣고 길이, 해상도, 화면 비율을 선택하며 필요 시 사운드를 켭니다.
3. 생성을 클릭하고 완성된 영상을 바로 다운로드합니다.

API 호출

1. 콘솔에서 API Key를 생성합니다.
2. POST https://api.hiapi.ai/v1/tasks로 제출하면 taskId가 반환됩니다.
3. GET /v1/tasks/{taskId}로 상태를 조회하고, status가 success이면 output[0].url에서 다운로드합니다.

curl: 텍스트 투 비디오

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-omni/text-to-video",
    "input": {
      "prompt": "A paper boat drifts down a rain-soaked city gutter at dusk, neon signs reflecting on the water.",
      "duration": 5,
      "resolution": "720p",
      "audio": false,
      "aspect_ratio": "16:9"
    }
  }'

Python: 제출, 폴링, 다운로드

import os, time, requests

H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, **inp):
    r = requests.post("https://api.hiapi.ai/v1/tasks",
                      json={"model": model, "input": inp}, headers=H)
    task_id = r.json()["data"]["taskId"]
    while True:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] in ("fail", "failed"):
            raise RuntimeError(d)
        time.sleep(10)

url = generate(
    "kling-3.0-omni/image-to-video",
    prompt="Morning fog slowly lifts over the harbor, camera slowly pushes in along the dock.",
    image_urls=["https://your-cdn.example.com/harbor.jpg"],
    duration=5, resolution="720p",
)
open("clip.mp4", "wb").write(requests.get(url).content)

나머지 세 엔트리는 어떻게 작성하나요?

이미지 투 비디오: image_urls에 1장을 전달하면 첫 프레임, 2장을 전달하면 첫 프레임과 마지막 프레임이 되며, 출력 화면 비율은 첫 프레임을 따릅니다.

Morning fog slowly lifts over the harbor as the fishing boats rock gently on the water; the low sun breaks through the haze and glints on the wet pier, camera slowly pushes in along the dock. Cinematic, calm, photorealistic.

이 프롬프트로 생성 →

레퍼런스 투 비디오: image_urls는 필수(1–7장, JPG/PNG, 장당 50MB 이하, 최단 변 300px 이상)이며, 카메라 워킹 레퍼런스로 video_urls 1개를 추가할 수 있습니다(MP4/MOV, 3–15.5초, 200MB 이하). 아래 영상은 종이배 첫 프레임 이미지를 주체 레퍼런스로, 위의 비 내리는 밤 비디오를 카메라 워킹 레퍼런스로 사용해 종이배를 숲속 시냇물로 옮긴 것입니다:

The same white paper boat from the reference drifts along a sunlit forest stream at golden hour, leaves floating beside it, camera tracks low alongside it with the same smooth motion as the reference video. Cinematic, shallow depth of field.

이 프롬프트로 생성 →

레퍼런스 비디오를 포함할 때 audio는 반드시 false여야 하며 스마트 멀티 샷을 켤 수 없고, 레퍼런스 이미지는 최대 4장까지입니다. 최소 요청:

{
  "model": "kling-3.0-omni/reference-to-video",
  "input": {
    "prompt": "The same white paper boat from the reference drifts along a forest stream",
    "image_urls": ["https://static.hiapi.ai/admin-assets/2026/10/13/1791861888668-6554d6167af93003-kling-omni-boat-frame.jpg"],
    "video_urls": ["https://static.hiapi.ai/admin-assets/2026/10/13/1791861859228-2b40d774dd4b2262-kling-omni-t2v-golden.mp4"],
    "duration": 3,
    "resolution": "720p",
    "audio": false
  }
}

여러 주체를 고정하려면 elements로 각 주체에 이름을 붙이고 프롬프트에 @이름을 작성합니다. 전체 작성법은 레퍼런스 투 비디오 프롬프트 사례를 참고하세요.

비디오 변환: video_urls에 원본 비디오 1개를 전달하고(MP4/MOV, 3–15.5초, 200MB 이하), 프롬프트에 무엇으로 바꿀지 작성합니다. 출력 길이와 화면 비율은 원본 비디오를 따르며 사운드는 생성하지 않습니다. 최소 요청:

{
  "model": "kling-3.0-omni/transformation",
  "input": {
    "prompt": "Transform the scene into a snowy winter night, keep the exact camera motion",
    "video_urls": ["https://static.hiapi.ai/admin-assets/2026/10/13/1791861859228-2b40d774dd4b2262-kling-omni-t2v-golden.mp4"],
    "resolution": "720p"
  }
}

같은 비 내리는 밤 종이배를 눈 내리는 밤에 빛나는 종이 등불배로 바꾼 것입니다:

Transform the scene into a snowy winter night: the gutter becomes a frozen stream with drifting snowflakes, the paper boat becomes a small glowing paper lantern boat, keep the exact camera motion and water movement from the original video. Cinematic, cold blue tones.

이 프롬프트로 생성 →

얼마인가요?

엔트리	720p	1080p	4K
텍스트 생성 / 이미지 생성, 사운드 끔	$0.10/초	$0.129/초	$0.479/초
텍스트 생성 / 이미지 생성, 사운드 켬	$0.129/초	$0.1645/초	$0.479/초
레퍼런스 생성, 레퍼런스 비디오 없음	동일	동일	동일
레퍼런스 생성, 레퍼런스 비디오 포함	$0.143/초	$0.193/초	$0.479/초
비디오 변환	$0.143/초	$0.193/초	$0.479/초

5초 720p 사운드 끈 텍스트 투 비디오 1편은 $0.50이며, $10로 100초를 생성할 수 있고 가장 짧은 3초는 $0.30입니다. 프롬프트 튜닝 시에는 먼저 720p와 3–5초로 테스트하고, 확정 후 1080p 또는 4K로 올리세요. 실패한 작업은 자동 환불됩니다.

출시 전 주의사항

• 폴링 대신 콜백 사용: 요청 최상위에 "callback": {"url": "https://당신의도메인/hiapi/callback"}를 추가하면 작업 성공 또는 실패 시 HiAPI가 능동적으로 알려주며, taskId로 중복을 제거하세요.
• 비디오는 기본 약 7일 보관: output[0].url을 받은 후 즉시 전송하여 보관하세요; 장기 보관이 필요하면 HiAPI의 영구 저장소를 사용할 수 있습니다(저장량에 따라 별도 과금).
• 파라미터는 엔트리에 맞게 모두 작성: 텍스트 생성, 이미지 생성, 레퍼런스 생성은 resolution, duration, audio를 명시적으로 작성하고; 비디오 변환은 resolution만 작성하며 길이는 원본 비디오를 따릅니다.
• 요소 이름에 공백 금지: elements[].name에 serum을 작성하고, 프롬프트에는 @serum을 작성합니다.

자주 묻는 질문

네 가지 엔트리를 각각 개통해야 하나요?

아니요. 동일한 API Key로 model만 바꾸면 됩니다.

세로 화면도 만들 수 있나요?

가능합니다. 텍스트 생성과 레퍼런스 생성은 aspect_ratio에 9:16을 작성하고; 이미지 생성은 첫 프레임 비율을 따르며 비디오 변환은 원본 비디오를 따릅니다.

사운드는 어떻게 추가하나요?

텍스트 생성, 이미지 생성, 레퍼런스 생성(레퍼런스 비디오 없을 때)에서 audio를 true로 설정하면 화면과 동기화된 환경음과 효과음이 생성됩니다. 720p는 초당 $0.029 추가, 1080p는 초당 $0.0355 추가입니다.

프롬프트를 중국어로 작성할 수 있나요?

가능합니다. 카메라가 어떻게 움직이는지, 주체가 무엇을 하는지, 조명과 스타일을 문장으로 나누어 명확히 작성하면 가장 안정적인 결과를 얻습니다.

위의 비 내리는 밤 종이배 프롬프트를 복사하여 모델 페이지에서 첫 영상 생성하기; 더 많은 복사 가능한 사례는 Kling 3.0 Omni 프롬프트 사례, 가격 세부 사항은 Kling 3.0 API 가격을 참고하세요.