Kling 3.0 Omni API

2026년 10월 19일 업데이트

Kling 3.0 Omni란?

Kling 3.0 Omni는 Kling 3.0의 풀 참조 변형입니다. 기본 3.0 엔드포인트가 프롬프트, 시작·종료 프레임, 멀티샷, 네이티브 오디오, 요소를 다룬다면, Omni는 그 위에 원본 참조 이미지(image_urls, 최대 7장), 명시적인 video_mode 스위치, 두 가지 참조 영상 동작(Reference와 Transform)을 더합니다. 모드는 생략(입력 없는 순수 텍스트-비디오 생성), elements(image_urls와 지속 요소, 합산 상한 7), start_end_frame, transform, video_reference입니다. 출력은 720p(Standard), 1080p(Pro), 4K이며, 315초 단일 샷 또는 26장면의 멀티샷 스택으로 생성합니다. 네이티브 오디오도 같은 호출에서 지원합니다. 참조 에셋이 많은 브리프이거나 참조가 영상일 때 Omni를 사용하세요.

주요 기능

Omni가 기본 Kling 3.0에 더하는 것은 다음 다섯 가지 기능으로 정리됩니다.

이런 작업에 적합합니다

• 참조가 많은 캠페인 작업

  최대 7장의 참조 이미지와 지속 요소. 고정 에셋(캐릭터, 제품, 환경, 브랜드 키트)이 많은 브리프에 유용합니다.

• 참조 영상의 스타일 또는 모션 전이

  스타일 전이는 video_mode: reference, 리타이밍과 재구성은 video_mode: transform. "@video의 모션을 따라 해 줘" 같은 브리프에 유용합니다.

• 캐릭터가 일관된 멀티샷

  Kling 3.0의 멀티샷 모드에 더 무거운 참조 처리를 결합합니다. 연속 캐릭터 작업에 유용합니다.

• 혼합 참조에 대한 Auto 화면 비율

  참조 영상을 설정하면 모델이 출력 비율을 고릅니다. 참조가 정사각형, 세로, 와이드스크린에 걸쳐 있을 때 유용합니다.

• 오디오를 유지한 스타일 전이

  룩을 바꾸면서도 네이티브 오디오를 영상에 맞춰 유지합니다. 음악 중심 컷과 연속 브랜드 작업에 유용합니다.

변형

세 가지 출력 모드와 video_mode 스위치가 있습니다. 해상도, 그리고 브리프의 중심이 이미지인지 프레임인지 참조 영상인지에 따라 선택하세요.

Standard

720p 출력 모드입니다. 영상당 비용이 낮고 빠르며, 레이아웃 탐색과 콘셉트 작업에 유용합니다.

Pro

1080p 출력 모드입니다. 히어로 영역이나 유료 지면에 올라갈 납품 컷의 기본 선택입니다.

4K

프리미엄 납품을 위해 엔드포인트에서 바로 4K를 출력하는 전용 모드입니다.

Reference (video_mode: video_reference)

선택적 참조 영상을 프롬프트 결과의 스타일 또는 모션 가이드로 다룹니다. image_urls와 elements를 합쳐 4개까지 허용하며, aspect_ratio는 auto여야 합니다.

Transform (video_mode: transform)

제공한 참조 영상의 동작을 더 강하게 편집하거나 리타이밍하는 데 초점을 둡니다. 상한과 화면 비율 규칙은 Reference와 같습니다.

멀티샷

26개 항목의 multi_shots 배열을 전달합니다. 각 샷은 자체 프롬프트와 길이를 가집니다. 총 길이는 315초 사이를 유지합니다.

활용 사례

캐릭터, 제품, 환경을 모두 원본 참조 이미지(최대 7장)로 전달하고 프롬프트에서 @image_1, @image_2, @image_3으로 참조하면 컷 전체에서 세 요소가 고정된 캠페인을 만들 수 있습니다. video_mode를 video_reference로 설정하고 트렌드 영상을 video_url로 전달하면, 프레임을 복사하지 않고도 기존 트렌드 영상의 모션 느낌을 이어받습니다. 더 강한 리스타일로 원본 영상을 재구성하려면 video_mode: transform으로 전환하세요. multi_shots 배열에 이어진 세 샷을 넣고 지속 요소로 주인공 캐릭터를 세 샷 전체에 유지하면 12초짜리 연속 컷이 완성됩니다.

API 예시

/v1/tasks에 POST 요청을 보내면 어떤 언어에서든 Kling 3.0 Omni를 호출할 수 있습니다. 전체 파라미터 문서는 docs.unifically.com/models/video/kling/kling-3.0-omni-video에 있습니다.

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "kuaishou/kling-3.0-omni-video",
    "input": {
      "prompt": "A majestic eagle soaring through mountain peaks at sunset",
      "duration": 5,
      "mode": "pro"
    }
  }'

제출에 성공하면 task_id가 반환됩니다. GET /v1/tasks/<task_id>를 폴링하거나 요청에 callback_url을 설정해 완료된 결과를 받으세요.