Kandinsky 6.0 Pro 사용법? 5분 만에 첫 영상 만들기

TL;DR

• 이것은 무엇인가: Sber가 만든 영상 모델로, 프롬프트 한 줄 또는 첫 프레임 이미지 한 장으로 동기화된 오디오가 포함된 5초 짧은 영상을 생성할 수 있습니다. 이미 HiAPI에 출시되어 Kandinsky 6.0 Pro 모델 페이지 열기에서 프롬프트를 입력하면 바로 생성할 수 있고, 신규 사용자 가입 시 200 크레딧을 증정합니다.
• 얼마인가: 건당 과금으로 텍스트 투 비디오 1건 $1.9286(약 3,857 크레딧), 이미지 투 비디오 1건 $2.00(4,000 크레딧)이며, 실패한 작업은 선차감 금액이 환불됩니다.
• 가장 빠른 호출 방법: POST https://api.hiapi.ai/v1/tasks에 model을 kandinsky-6.0-pro/text-to-video로 지정하고, taskId를 받은 후 폴링하거나 콜백을 기다렸다가 data.output[0].url에서 MP4를 다운로드합니다.

출시 후 가장 많이 받은 질문 두 가지: 다른 영상 모델과 무엇이 다른가, 자사 제품에 연동하려면 몇 단계가 필요한가. 전자는 아래 네 가지를 보면 되고, 후자는 5분이면 충분합니다.

Kandinsky 6.0 Pro란? 무엇이 새로운가

가장 큰 변화는 화면과 사운드가 함께 생성된다는 점입니다. 프롬프트에 소리도 함께 적으면 완성 영상의 바퀴 소리, 빗소리, 사람 목소리가 화면과 함께 움직여 별도로 더빙할 필요가 없습니다.

• 동기화 오디오. Kandinsky 5.x는 화면만 출력했지만, 이 세대는 사운드 트랙이 추가되어 한 작업으로 동기화된 오디오 트랙이 포함된 MP4를 바로 얻습니다.
• 5초, 480p, 24fps 고정. 길이와 해상도를 선택할 필요가 없으며, 16:9 실제 출력은 864×480으로 숏폼 콘티와 소재 테스트에 딱 맞는 크기입니다.
• 다섯 가지 화면 비율. 텍스트 투 비디오는 16:9, 9:16, 1:1, 4:3, 3:4를 지원해 세로, 정방형, 가로를 한 번에 커버하며, 이미지 투 비디오는 auto가 하나 더 있어 첫 프레임에 맞춰 자동 매칭합니다.
• 두 모델 ID의 역할이 명확. kandinsky-6.0-pro/text-to-video는 텍스트에서 시작하고, kandinsky-6.0-pro/image-to-video는 이미지를 첫 프레임으로 삼아 프롬프트에는 이후에 벌어질 일만 묘사합니다.

▶ 이 5초 완성 영상 보기: 달밤 기차가 돌 아치교를 지나고 증기가 계곡으로 흘러간다

텍스트 투 비디오, 16:9, 864×480, 24fps, 소리와 화면이 같은 작업에서 생성됨.

이 프롬프트로 생성하기 →

두 가지 시작 경로: 온라인 체험 vs API 연동

온라인 체험(1분)

1. Kandinsky 6.0 Pro 모델 페이지를 열면 위 링크를 통해 프롬프트가 자동으로 입력됩니다.
2. 화면 비율을 확인하고, 가로는 16:9, 세로는 9:16을 선택합니다.
3. 생성을 누르면 작업이 끝난 후 페이지에서 재생하고 다운로드할 수 있습니다.

API 연동(3단계)

1. 콘솔에서 API Key를 생성합니다.
2. POST /v1/tasks로 제출하며, model과 input.prompt 두 필드만 있으면 실행됩니다.
3. GET /v1/tasks/{taskId}로 폴링하거나 제출 시 callback을 함께 보냅니다. status가 success가 되면 data.output[0].url을 가져옵니다.

첫 영상: curl 버전

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kandinsky-6.0-pro/text-to-video",
    "input": {
      "prompt": "A night train crosses a tall stone viaduct under a full moon, a plume of steam trailing into the valley, the camera cranes up from the river below, rhythmic wheels on the rails and a distant whistle",
      "aspect_ratio": "16:9",
      "guidance_scale": 5
    }
  }'

반환되는 것은 영상이 아니라 작업입니다:

{"code":200,"data":{"taskId":"tk-hiapi-..."},"message":"success"}

이 ID로 상태를 조회합니다:

curl -s https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-YOUR_KEY"

작업이 실행 중일 때 data.status는 handling이고, 성공하면 data.output[0].url이 MP4 주소입니다. aspect_ratio를 전달하지 않으면 기본 16:9이며, guidance_scale은 1–10, 기본 5로 프롬프트에 더 붙이고 싶으면 높입니다. 원하지 않는 것은 negative_prompt에 적으며 최대 2,000자입니다. seed에 정수를 전달하면 같은 결과를 최대한 재현할 수 있습니다.

Python 버전: 제출, 폴링, 다운로드를 한 번에

import os, time, requests

BASE = "https://api.hiapi.ai"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}
PROMPT = "A night train crosses a tall stone viaduct under a full moon, a plume of steam trailing into the valley, the camera cranes up from the river below, rhythmic wheels on the rails and a distant whistle"

r = requests.post(f"{BASE}/v1/tasks", headers=H, json={
    "model": "kandinsky-6.0-pro/text-to-video",
    "input": {"prompt": PROMPT, "aspect_ratio": "16:9"},
}, timeout=30)
r.raise_for_status()
task_id = r.json()["data"]["taskId"]
print("이 ID를 먼저 저장하세요:", task_id)

while True:
    d = requests.get(f"{BASE}/v1/tasks/{task_id}", headers=H, timeout=20).json()["data"]
    if d["status"] == "success":
        break
    if d["status"] != "handling":
        raise RuntimeError(f"작업 실패: {d}")
    time.sleep(15)

open("clip.mp4", "wb").write(requests.get(d["output"][0]["url"], timeout=120).content)

폴링 간격은 15초로 두세요. 영상 작업은 비동기이므로 너무 자주 조회하면 API 호출만 늘어날 뿐 상태가 더 빨리 바뀌지 않습니다.

이미지 투 비디오: 모델 ID를 바꾸고 첫 프레임 한 장 추가

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kandinsky-6.0-pro/image-to-video",
    "input": {
      "prompt": "Rain intensifies on the empty street, neon reflections ripple in the puddles, steam rises from a grate beside the booth, the camera slowly pushes in, steady rain and distant traffic",
      "image_url": "https://static.hiapi.ai/admin-assets/kandinsky-6-pro/2026/10/26/1793005005686-69a9b6e8a000188b-k-i2v-input.png",
      "aspect_ratio": "auto"
    }
  }'

image_url은 필수 첫 프레임으로 JPG, PNG, WebP를 지원합니다. aspect_ratio는 기본 auto로 첫 프레임에서 가장 가까운 비율을 골라 중앙 크롭하며, 16:9, 9:16, 1:1, 4:3, 3:4를 명시해 다시 구도화할 수도 있습니다. 이 이미지 투 비디오 완성 영상 보기 →

프롬프트 작성법: 장면, 동작, 카메라, 사운드

네 층으로 명확히 쓰면 5초 분량의 정보량은 딱 들어갑니다:

• 장면: 장소, 시간, 조명, 날씨 — A night train crosses a tall stone viaduct under a full moon
• 동작: 주체가 무엇을 하는지, 속도가 얼마나 빠른지 — a plume of steam trailing into the valley
• 카메라: 위치와 움직임 — the camera cranes up from the river below
• 사운드: 듣고 싶은 것, 이 트랙은 화면과 같은 소스 — rhythmic wheels on the rails and a distant whistle

가장 놓치기 쉬운 것은 사운드입니다. 화면만 쓰면 소리는 모델이 추측할 수밖에 없습니다. 빗소리, 발소리, 멀리 지나는 차량 소리를 적어야 음향과 화면이 맞습니다. 프롬프트는 영어로 쓰는 것이 가장 안정적이며, 한국어 아이디어는 먼저 영어로 번역해 제출하세요. 단일 최대 6,000자입니다.

출시 전 주의할 4가지

1. 서버는 callback을 사용. 요청 본문에 "callback": {"url": "https://yourapp.com/webhook"}을 추가하면 작업 종료 시 자동 알림을 받고, 폴링은 보조 수단으로만 사용합니다. 폴링 타임아웃 시 다시 POST하지 말고 taskId를 저장한 뒤 조회하세요. 매번 제출은 새 작업이며 재과금됩니다.
2. 결과물 링크는 만료됩니다. 성공 응답의 URL에는 expireAt이 있으므로 받는 즉시 자체 스토리지에 다운로드하고, 장기 주소로 비즈니스 DB에 기록하지 마세요.
3. 프롬프트 언어. 영어와 러시아어를 원래 지원하며, 중국어 프롬프트는 먼저 영어로 번역하면 화면 일치도와 음향 정확도가 더 안정적입니다.
4. 이미지 투 비디오의 aspect_ratio=auto는 크롭합니다. 첫 프레임 구도를 온전히 유지하려면 첫 프레임과 같은 비율을 명시하고, 플랫폼 화면 비율에 맞추려면 auto가 가장 간편합니다.

전체 필드는 중국어 문서에서 확인하세요.

자주 묻는 질문

Kandinsky 6.0 Pro의 모델 ID는 무엇인가요? 텍스트 투 비디오 kandinsky-6.0-pro/text-to-video, 이미지 투 비디오 kandinsky-6.0-pro/image-to-video이며, POST /v1/tasks의 model 필드에 적습니다.

길이나 해상도를 선택할 수 있나요? 지원하지 않으며, 출력은 5초, 480p, 24fps로 고정됩니다. 720p 이상 사양이 필요하면 Kling 3.0 또는 Seedance 2.0 텍스트 투 비디오 라인으로 바꾸세요.

완성 영상에 소리가 있나요? 있으며 항상 켜져 있습니다. 소리는 같은 프롬프트에서 생성되므로 듣고 싶은 것을 프롬프트에 적으면 됩니다.

어떤 화면 비율을 지원하나요? 텍스트 투 비디오는 16:9, 9:16, 1:1, 4:3, 3:4이고, 이미지 투 비디오는 auto가 추가로 있어 기본적으로 첫 프레임에 가장 가까운 비율로 맞춥니다.

한 번에 몇 개를 만들 수 있나요? 작업 하나에 5초 영상 하나이며 건당 과금되고 실패한 작업은 선차감 금액이 환불됩니다. 여러 개가 필요하면 여러 작업을 동시에 생성하세요.

위의 야간 열차 프롬프트를 복사해 모델 페이지에서 첫 5초 영상을 생성하세요. 화면 비율은 16:9를 선택하면 되고, 사운드는 이미 프롬프트에 적혀 있습니다.