HiAPI
블로그

사용 가이드

Kling 3.0 Omni 레퍼런스 투 비디오: 바로 복사할 수 있는 프롬프트 레시피 3가지와 실제 결과 영상

Oct 14, 2026
Kling 3.0 Omni 레퍼런스 투 비디오: 바로 복사할 수 있는 프롬프트 레시피 3가지와 실제 결과 영상

참조 이미지로 동일한 제품이나 캐릭터를 여러 장면에 걸쳐 이끌어 가는 것, 바로 Kling 3.0 Omni 레퍼런스 투 비디오(kling-3.0-omni/reference-to-video)가 HiAPI에서 하는 일입니다. 아래에 세 가지 레시피(제품 하나, 캐릭터 하나, 그리고 둘이 함께 나오는 장면)를 제시하며, 각각 정확한 요청과 그것이 생성한 결과 영상을 함께 첨부합니다. 세 편 모두 1080p로 생성되었고 총 $2.064입니다. 모델 페이지를 열면 바로 하나를 실행할 수 있으며, 신규 계정에는 무료 200 크레딧이 지급됩니다.

일반적인 텍스트 투 비디오 호출은 당신이 글로 설명한 내용만 알기 때문에, 생성할 때마다 조금씩 다른 피사체가 만들어집니다. 반면 레퍼런스 투 비디오는 관심 있는 피사체의 이미지를 사용하여, 당신이 프롬프트로 카메라, 움직임, 장면을 지시하는 동안 그 외형을 그대로 유지합니다.

레퍼런스 투 비디오의 작동 방식

일반적인 텍스트 투 비디오 호출은 당신이 글로 설명한 내용만 압니다. 「하얀 로봇 마스코트」는 카테고리이지 정체성이 아니므로, 생성할 때마다 조금씩 다른 로봇이 만들어집니다. Kling 3.0 Omni는 정체성을 고정하는 두 가지 방법을 제공합니다:

  • image_urls(필수, 1–7장): 피사체, 제품 또는 스타일의 참조 이미지. 단일 피사체를 고정하는 가장 간단한 방법은 여기에 그 피사체의 두 각도를 전달하는 것입니다.
  • elements(선택, 최대 7개): 이름이 붙은 재사용 가능 피사체. 각각 name(공백 없음), 간단한 description, 그리고 동일 피사체의 2–4장 element_input_urls를 가집니다. 프롬프트에서 @name으로 호출하며, 이것이 한 화면에서 여러 피사체를 구분하는 방법입니다.

그다음 프롬프트가 변해야 할 모든 부분—카메라, 조명, 동작, 장면—을 담당하고, 참조 이미지가 정체성을 지킵니다.

입력 구조, 30초면 파악

필드 타입 설명
prompt string 장면, 카메라 및 움직임; @name으로 요소 호출
image_urls string[] 필수. 참조 이미지 1–7장(참조 영상 포함 시 최대 4장)
elements[] object[] 선택. 각각 name, description, 2–4개의 element_input_urls 포함
video_urls string[] 선택. 움직임과 카메라 참조로 사용할 3–15.5초 클립
duration integer 3–15초, 기본값 5
resolution enum 720p(기본), 1080p 또는 4k
audio boolean 네이티브 사운드, 기본값 false; 참조 영상 포함 시 반드시 false 유지
aspect_ratio enum 16:9(기본), 9:16 또는 1:1

참조 이미지와 요소 피사체는 하나의 할당량을 공유합니다: 총 7개, 참조 영상을 추가할 경우 4개.


레시피 1 —— 단일 제품 고정

가장 간단한 경우: 카메라가 움직이는 동안 하나의 피사체를 충실하게 재현합니다. 피사체는 호박색 유리 세럼 병이며, 두 참조 각도를 image_urls에 직접 넣습니다:

프롬프트:

시네마틱 스킨케어 제품 공개. 카메라가 참조 이미지의 호박색 유리 세럼 병을 천천히 푸시인하며, 병은 원형 흰색 대리석 받침대 위에 서 있고, 왼쪽 위에서 부드러운 확산 스튜디오 조명이 비치며, 뒤로 희미한 볼류메트릭 헤이즈가 있습니다. 황금빛 세럼 한 방울이 천천히 맺혀 검은 스포이드 끝에 매달립니다. 얕은 심도, 프리미엄 상업적 질감, 카메라가 천천히 다가갈 때 부드러운 하이라이트가 호박색 유리에 미끄러집니다.

요청:

{
  "model": "kling-3.0-omni/reference-to-video",
  "input": {
    "prompt": "시네마틱 스킨케어 제품 공개. 카메라가 참조 이미지의 호박색 유리 세럼 병을 천천히 푸시인하며, 병은 원형 흰색 대리석 받침대 위에 서 있고, 왼쪽 위에서 부드러운 확산 스튜디오 조명이 비치며, 뒤로 희미한 볼류메트릭 헤이즈가 있습니다. 황금빛 세럼 한 방울이 천천히 맺혀 검은 스포이드 끝에 매달립니다. 얕은 심도, 프리미엄 상업적 질감, 카메라가 천천히 다가갈 때 부드러운 하이라이트가 호박색 유리에 미끄러집니다.",
    "image_urls": [
      "https://static.hiapi.ai/gallery/2026/10/bf90e69bd4d2b13b.jpg",
      "https://static.hiapi.ai/gallery/2026/10/ae754fb5c5e53ed4.jpg"
    ],
    "duration": 5,
    "resolution": "1080p",
    "audio": false,
    "aspect_ratio": "16:9"
  }
}

결과(5초, 1080p, 사운드 꺼짐):

이 프롬프트로 생성하기 →

왜 효과적인가: 프롬프트는 피사체를 한 번만 언급하며(「참조 이미지의 호박색 유리 세럼 병」), 나머지 모든 단어는 연출 지시에 쓰입니다: 푸시인, 스튜디오 조명, 스포이드 끝의 방울. 병의 형태, 홈이 있는 검은 캡, 호박색 유리는 다가가는 동안 일관되게 유지되고, 마지막에 병의 클로즈업으로 끝납니다.


레시피 2 —— 캐릭터 고정

제품을 캐릭터로 바꾸면 방법 자체는 전혀 달라지지 않습니다. 피사체는 정면 뷰와 4분의 3 뷰를 참조로 사용하는 오리지널 마스코트입니다:

프롬프트:

참조 이미지의 무광 화이트 로봇 마스코트가 아늑하고 햇살 가득한 카페에 서 있고, 뒤쪽 창문으로 따뜻한 아침 빛이 들어옵니다. 한쪽 팔로 즐겁게 손을 흔들고, 고개를 갸웃하며, 안테나가 살짝 흔들립니다. 부드럽고 친근한 움직임, 배경의 나무 카페 선반이 만드는 부드러운 보케, 카메라가 천천히 부드럽게 푸시인, 치유계 애니메이션 영화 질감.

요청:

{
  "model": "kling-3.0-omni/reference-to-video",
  "input": {
    "prompt": "참조 이미지의 무광 화이트 로봇 마스코트가 아늑하고 햇살 가득한 카페에 서 있고, 뒤쪽 창문으로 따뜻한 아침 빛이 들어옵니다. 한쪽 팔로 즐겁게 손을 흔들고, 고개를 갸웃하며, 안테나가 살짝 흔들립니다. 부드럽고 친근한 움직임, 배경의 나무 카페 선반이 만드는 부드러운 보케, 카메라가 천천히 부드럽게 푸시인, 치유계 애니메이션 영화 질감.",
    "image_urls": [
      "https://static.hiapi.ai/blog/kling-3-0-omni-reference-to-video-prompt-recipes/ref-mascot-01.jpg",
      "https://static.hiapi.ai/blog/kling-3-0-omni-reference-to-video-prompt-recipes/ref-mascot-02.jpg"
    ],
    "duration": 5,
    "resolution": "1080p",
    "audio": false,
    "aspect_ratio": "16:9"
  }
}

결과(5초, 1080p, 사운드 꺼짐):

이 프롬프트로 생성하기 →

왜 효과적인가: 마스코트는 완전히 새로운 환경(햇살 가득한 카페)에 들어가 새로운 동작(손 흔들기와 미소)을 하지만, 민트색 바이저, 동그란 눈, 배꼽 버튼, 신체 비율은 모델링 그대로 유지됩니다. 같은 정체성, 완전히 새로운 연기.


레시피 3 —— 한 화면에 두 피사체

바로 여기서 elements가 가치를 발휘합니다. 마스코트와 세럼 병을 두 개의 명명된 요소로 정의한 다음, 프롬프트에서 @mascot과 @serum으로 지시합니다. image_urls는 여전히 필수이므로 병의 한 각도도 넣습니다:

프롬프트:

깔끔하고 발랄한 제품 광고. @mascot이 원형 흰색 대리석 받침대 옆에 서서 한쪽 팔로 받침대 위에 놓인 @serum을 가리키며 시청자에게 보여줍니다. @mascot이 병을 힐끗 본 뒤 고개를 돌려 카메라를 바라봅니다. 부드러운 확산 스튜디오 조명, 연한 민트색 심리스 배경, 카메라가 천천히 부드럽게 푸시인, 고급스러우면서도 친근한 브랜드 광고 질감.

요청:

{
  "model": "kling-3.0-omni/reference-to-video",
  "input": {
    "prompt": "깔끔하고 발랄한 제품 광고. @mascot이 원형 흰색 대리석 받침대 옆에 서서 한쪽 팔로 받침대 위에 놓인 @serum을 가리키며 시청자에게 보여줍니다. @mascot이 병을 힐끗 본 뒤 고개를 돌려 카메라를 바라봅니다. 부드러운 확산 스튜디오 조명, 연한 민트색 심리스 배경, 카메라가 천천히 부드럽게 푸시인, 고급스러우면서도 친근한 브랜드 광고 질감.",
    "image_urls": [
      "https://static.hiapi.ai/gallery/2026/10/bf90e69bd4d2b13b.jpg"
    ],
    "elements": [
      {
        "name": "mascot",
        "description": "부드러운 민트 그린 포인트가 있는 작고 무광 화이트의 둥근 로봇 마스코트, 짧은 안테나 끝에 작은 공, 크고 둥근 짙은 눈, 배에 동그란 민트 그린 버튼",
        "element_input_urls": [
          "https://static.hiapi.ai/blog/kling-3-0-omni-reference-to-video-prompt-recipes/ref-mascot-01.jpg",
          "https://static.hiapi.ai/blog/kling-3-0-omni-reference-to-video-prompt-recipes/ref-mascot-02.jpg"
        ]
      },
      {
        "name": "serum",
        "description": "호박색 유리 스킨케어 세럼 병, 검은 고무 볼 유리 스포이드 캡 포함",
        "element_input_urls": [
          "https://static.hiapi.ai/gallery/2026/10/bf90e69bd4d2b13b.jpg",
          "https://static.hiapi.ai/gallery/2026/10/ae754fb5c5e53ed4.jpg"
        ]
      }
    ],
    "duration": 6,
    "resolution": "1080p",
    "audio": false,
    "aspect_ratio": "16:9"
  }
}

결과(6초, 1080p, 사운드 꺼짐):

이 프롬프트로 생성하기 →

왜 효과적인가: 각 피사체는 자체 참조 이미지 쌍을 가진 자신만의 요소이므로 모델이 독립적으로 추적합니다. 마스코트는 디자인을 유지하고, 병은 형태를 유지하며, 프롬프트는 둘 사이의 관계를 연출합니다: 카메라가 다가갈 때 마스코트가 받침대 위의 병을 향해 손을 뻗습니다.

정체성을 진짜로 지키는 참조 작성법

  • 각 피사체에 두 개 이상의 각도를 제공하세요. 동일 피사체의 다양한 각도는 모델에게 무엇이 불변인지 가르칩니다. 각 요소에는 2–4장의 이미지가 필요합니다.
  • 정체성은 참조 이미지에, 연출 지시는 프롬프트에. 피사체가 무엇인지는 이미지와 description에, 무슨 일이 일어나는지는 프롬프트에 넣으세요.
  • @name으로 요소를 호출하세요. 이름에는 공백이 없어야 하며(serum bottle이 아니라 serum), 프롬프트에서 반드시 @serum으로 정확히 참조하세요.
  • 요소 블록을 재사용해 캠페인을 구축하세요. 위의 두 레시피는 동일한 마스코트와 병 참조를 사용합니다. 여러 호출에 걸쳐 재사용하면 한 시리즈의 브랜드 일관성을 유지할 수 있습니다.
  • 참조 영상을 추가해 카메라 움직임을 지정하세요. video_urls에 클립을 넣으면 새 장면이 그 움직임과 카메라 언어를 따릅니다. 이때 audio는 꺼 두세요.

API로 재현하기

레퍼런스 투 비디오는 HiAPI의 비동기 작업 API에서 실행됩니다. 작업을 제출한 다음 완료될 때까지 폴링하세요:

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/reference-to-video",
    "input": {
      "prompt": "@serum이 대리석 받침대 위에 있고, 느린 푸시인, 부드러운 스튜디오 조명",
      "image_urls": ["https://.../ref-1.jpg"],
      "elements": [
        {
          "name": "serum",
          "description": "호박색 유리 세럼 병, 검은 스포이드 캡 포함",
          "element_input_urls": ["https://.../ref-1.jpg", "https://.../ref-2.jpg"]
        }
      ],
      "duration": 5,
      "resolution": "1080p",
      "audio": false,
      "aspect_ratio": "16:9"
    }
  }'

응답은 taskId를 반환합니다. GET /v1/tasks/{taskId}를 폴링하여 status가 success가 될 때까지 확인한 다음, output[0].url에서 클립을 다운로드하세요(출력은 기본적으로 약 7일간 보관되므로 자체 스토리지에 저장하거나 HiAPI 영구 스토리지로 전환하세요). 프로덕션 환경에서는 최상위 callback.url을 전달하면 HiAPI가 작업 완료 시 당신의 서비스에 알립니다. 전체 파라미터는 Kling 3.0 Omni 레퍼런스 투 비디오 API 문서를 참조하세요.

가격

Kling 3.0 Omni 레퍼런스 투 비디오는 출력 초 수로 과금되며, 해상도와 사운드에 따라 달라집니다:

해상도 사운드 꺼짐 사운드 켜짐 참조 영상 포함
720p $0.10/초 $0.129/초 $0.143/초
1080p $0.129/초 $0.1645/초 $0.193/초
4k $0.479/초 $0.479/초 $0.479/초

위의 세 레시피는 1080p, 사운드 꺼짐으로 실행되었습니다: 5초 클립마다 $0.645, 6초 클립은 $0.774, 세 편 합계 $2.064입니다. 먼저 720p로 시험 제작(5초 클립당 $0.50)한 다음, 선택한 버전을 1080p 또는 4k로 다시 실행하세요. 클립 길이는 3–15초이며, 실패한 작업은 자동으로 환불됩니다.

자주 묻는 질문

레퍼런스 투 비디오와 이미지 투 비디오의 차이는 무엇인가요? 이미지 투 비디오는 하나의 시작 프레임을 움직이게 합니다—전체 장면이 그 이미지에서 자라납니다. 레퍼런스 투 비디오는 피사체를 휴대하며, 그 주위로 새로운 장면을 재구성할 수 있게 합니다. 정확히 원하는 움직임의 첫 프레임이 있을 때는 이미지 투 비디오를, 동일한 캐릭터나 제품을 여러 다른 장면에 걸쳐 유지해야 할 때는 레퍼런스 투 비디오를 사용하세요.

한 클립에 몇 개의 피사체를 담을 수 있나요? 참조 이미지와 요소 피사체를 합쳐 호출당 최대 7개, 참조 영상 포함 시 4개—캐릭터 하나에 소품 몇 개를 더하기에 충분합니다.

왜 제 요소가 거부되었나요? 각 요소의 element_input_urls에는 2–4장의 이미지가 필요하고 name에는 공백이 없어야 합니다. 또한 요청에 image_urls 항목이 최소 하나 있는지 확인하세요.

사운드를 얻을 수 있나요? 네. 참조 영상이 없을 때 audio: true로 설정하면 네이티브 환경음과 효과음을 얻을 수 있습니다. 720p에서는 초당 $0.029, 1080p에서는 초당 $0.0355가 추가됩니다.

참조 없이 텍스트만 원한다면요? Kling 3.0 Omni 텍스트 투 비디오를 사용하세요: 동일한 엔진, 프롬프트만 사용.

핵심 요점

레퍼런스 투 비디오는 「어떤 캐릭터」를 당신의 캐릭터로 바꿉니다. 각 피사체에 몇 개의 참조 각도를 주고, @name으로 호출하고, 프롬프트가 연출을 담당하게 하면, 장면마다 드리프트와 씨름하는 대신 일관된 시리즈 전체를 찍을 수 있습니다. 레시피 3을 복사하고 모델 페이지에서 첫 두 피사체 클립을 실행하세요. 해당 링크는 프롬프트를 미리 채웁니다; 여기에 위 요청의 참조 이미지와 요소를 추가하세요. 진입점과 요금을 비교하려면 Kling 3.0 API 가격 가이드를 참조하세요.

영구 AI 아티팩트로 빌드 시작하기

API 키를 받아 태스크 기반의 하나의 API로 이미지, 비디오, 오디오 모델을 호출하세요.

API 문서 보기