개발자 문서

예시

영상 예시

영상은 몇 분 걸릴 수 있습니다. 기다리기 싫으면 --no-wait 로 접수만 하고 aimz jobs 로 나중에 받으세요.

사진 한 장을 영상으로

시작 프레임(start_frame)에 내 PC 파일 경로를 주면 자동으로 올라갑니다. 프롬프트에는 움직임을 적습니다.

터미널
aimz generate seedance_fast --prompt "카메라가 천천히 다가가고 머리카락이 바람에 날린다" -p start_frame=./portrait.png -p duration=5 -p resolution=720p -o ./out

첫 프레임 → 끝 프레임

두 장면 사이를 이어 주는 영상입니다. 끝 프레임은 시작 프레임과 함께만 쓸 수 있습니다.

터미널
aimz generate seedance_fast --prompt "낮에서 밤으로 시간이 흐르고 가로등이 하나씩 켜진다" -p start_frame=./street_day.png -p end_frame=./street_night.png -p duration=6 -o ./out

소리까지 함께

Kling 3.0 은 audio=native 로 장면에 맞는 소리(효과음·주변음)를 같이 만듭니다. 값이 1.5배가 됩니다.

터미널
aimz generate kling-3 --prompt "파도가 바위에 부서지고 갈매기가 운다" -p duration=5 -p resolution=1080p -p audio=native -o ./out

스토리보드 — 컷 이미지를 한꺼번에 영상으로

컷 이미지를 aimz batch 로 한 번에 만들고, 저장된 그림마다 영상을 하나씩 적은 파일을 만들어 다시 batch 로 넣습니다. 승인은 각 단계에서 한 번이고, 영상 여러 개가 서버 대기열에서 동시에 만들어져 전체 시간이 짧아집니다.

board.json
[
  {"model_id": "nanobanana", "params": {"prompt": "컷1: 새벽 항구, 어부가 그물을 정리한다, 시네마틱", "aspect_ratio": "16:9"}},
  {"model_id": "nanobanana", "params": {"prompt": "컷2: 같은 어부가 작은 배를 몰고 바다로 나간다", "aspect_ratio": "16:9"}},
  {"model_id": "nanobanana", "params": {"prompt": "컷3: 해 질 녘 만선으로 돌아오는 배", "aspect_ratio": "16:9"}}
]
터미널
aimz batch board.json --session storyboard --wait -o ./board
# board 폴더의 그림마다 영상 한 개
$items = Get-ChildItem ./board -File | ForEach-Object {
  @{ model_id = "seedance_fast"; params = @{ prompt = "잔잔하게 앞으로 다가가는 카메라"; start_frame = [string]$_.FullName; duration = 5 } }
}
[IO.File]::WriteAllText("$PWD\clips.json", (ConvertTo-Json -InputObject @($items) -Depth 5))   # BOM 없는 UTF-8
aimz batch clips.json --session storyboard --wait -o ./clips
참고
영상은 대기열 차례에 따라 몇 분 걸릴 수 있습니다. --wait 를 빼면 작업 번호만 받고 바로 끝나며, 나중에 aimz wait <번호들> -o ./clips 로 모아 받습니다. 지금 대기 상황은 aimz queue, 실패 이유는 aimz failures.

참고 영상의 움직임 따라 하기

목록 값(참고 영상·참고 이미지 여러 장)은 JSON 파일로 넘기면 셸마다 따옴표 규칙이 달라 생기는 문제가 없습니다. 파일 안의 경로도 자동으로 올라갑니다.

params.json
{
  "ref_videos": ["./dance.mp4"],
  "duration": 8,
  "resolution": "720p"
}
터미널
aimz generate seedance_25 --prompt "참고 영상의 춤 동작을 따라 하는 종이 인형" --params-json @params.json -o ./out

모델마다 참고 영상의 개수·길이 한도가 다릅니다(예: Seedance 2.5 는 다 합쳐 30초). aimz model seedance_25 로 확인하세요.

긴 영상은 접수만 하고 나중에

터미널
aimz generate wan_30 --prompt "도시의 하루를 담은 타임랩스" -p duration=20 -p resolution=1080p --no-wait
# 접수: j_3a313f12…

aimz jobs                                  # 진행 중인 작업 목록
aimz jobs j_3a313f12… --wait -o ./out       # 끝날 때까지 기다렸다가 저장