HiAPI
블로그

사용 가이드

Seedance 2.5 참조 기반 영상 생성: TikTok·Reels 숏폼 클립을 위한 가이드

실제 클립 3개, 참조 모드 3가지, 그리고 세로형 숏폼 출력의 핵심 필드

Aug 15, 2026
Seedance 2.5 참조 기반 영상 생성: TikTok·Reels 숏폼 클립을 위한 가이드
모델
seedance-2.5

seedance-2.5/reference-to-video는 빈 프롬프트에서 출발하지 않고, 이미 가지고 있는 소재에서 새 클립을 생성합니다. 참조 영상 하나를 지정하면 해당 클립의 카메라 무빙, 리듬, 동작을 유지하면서主体를 교체하거나 스타일을 바꾸거나 참조 오디오 트랙을 얹을 수 있습니다. 숏폼 제작에서는 이것이 TikTok이나 Reels 아이디어를 다시 촬영할지, 좋은 소재 하나를 여러 편으로 재편집할지를 결정합니다. 아래는 이런 방식으로 생성한 실제 클립 3개(전체 프롬프트 포함)와, 세로형·짧은 길이 출력에서 실제로 중요한 필드입니다.

숏폼 재편집에 특히 잘 맞는 이유

TikTok/Reels 제작과 높은 궁합을 보이는 세 가지가 있습니다:

  • aspect_ratio: "9:16"은 실제로 설정 가능한 필드입니다 — 사후 크롭이 아니라 모델이 직접 세로 화면으로 렌더링합니다.
  • reference_video_urls가 카메라 연출을 담당합니다. 리듬, 편집, 구도가 이미 요구 사항에 맞는 소재가 있다면, 다른 피사체나 스타일을 시도하려고 촬영을 새로 설계할 필요가 없습니다.
  • 길이는 설계상 짧습니다. duration은 최대 30초이며 입력한 참조 영상 길이와 연동됩니다. 이 모델은 긴 영상 출력이 아니라 클립을 위해 만들어졌습니다.

예시 1: 피사체 교체, 카메라 경로 유지

소스 참조는 트레일 러닝화 광고입니다. 프롬프트는 카메라 전진 순서를 유지하고 제품만 전체 교체했습니다:

将 @video1 严格作为镜头推进、产品旋转、运镜路径、节奏、微距特写和灯光过渡的参考。将鞋子完全替换为 @image1 中的香水瓶。在每个镜头中保留瓶身精确的轮廓、琥珀色玻璃色泽、瓶盖比例、标签位置和高端材质外观。将其呈现为深色黑曜石台座上的奢华香水广告,配以温暖的琥珀色轮廓光、受控的反光、细腻的环境雾气与精准的微距细节。遵循 @video1 的视觉节奏与运镜编排,同时自始至终保持同一只香水瓶。不得将鞋带、鞋底、织物纹理或鞋形几何结构转移到瓶身上。不得凭空添加额外产品、可读的品牌文字、标志、手或人物。

@video1과 @image1은 프롬프트 텍스트 안의 참조 마커로, 어떤 업로드 파일이 어떤 역할을 맡는지 모델에 알려 줍니다. 여기서 @video1(신발 클립, reference_video_urls로 전달)은 동작과 카메라 무빙을 제공하고, @image1(향수병, reference_image_urls로 전달)은 피사체 정체성을 제공합니다. 끝의 부정 지시(“신발 끈을 전이하지 말 것…”)는 긍정 묘사만큼 중요합니다. 명시적으로 배제하지 않으면 참조 기반 영상 생성은 소스 클립의 불필요한 디테일까지 함께 가져오기 때문입니다. 이 클립은 480p, 9:16, 4초로 렌더링되었고 오디오는 모델이 네이티브로 생성·동기화했습니다(이 클립에는 별도 오디오 참조를 제공하지 않았습니다).

예시 2: 동작만 이전하고 나머지는 전부 스타일 변경

이 클립은 reference_video_urls만 사용합니다 — 이미지나 오디오 참조 없이 — 동작을 완전히 다른 시각 스타일로 옮깁니다:

将 @video1 作为唯一的视觉参考。保留柯基犬可辨识的斑纹、奔跑节律、步幅时序、身体朝向、前进动量,以及低位侧向跟拍运镜。将整个场景重新想象为由毛毡、羊毛、微型草地和手绘纸质布景制成的手工定格动画。保留温暖的日落逆光和连续的追逐节奏,并带有细腻的手工质感与自然景深。整个镜头中保持同一只连贯的柯基犬、解剖结构稳定的腿部、平滑的前进动作和连续的运镜路径。不得引入额外动物、文字、标志、突兀剪辑或无关物体。

가장 이해하기 쉬운 모드입니다. 참조 영상 하나와, 무엇을 유지할지(리듬, 카메라 경로) 무엇을 바꿀지(표면, 재질, 조명 선택 전부)를 구분하는 명확한 지시 하나가 있습니다. 기존 소재의 피사체를 교체하는 것이 아니라 스타일을 뒤집는 것이 목표라면 좋은 기본 선택입니다.

예시 3: 영상·이미지·오디오 삼중 결합

가장 난도가 높은 모드는 세 가지 참조 유형을 모두 겹쳐 사용하고 출력을 오디오 타임라인에 맞추도록 모델에 요구합니다:

使用 @video1 作为工匠手部动作、工坊操作、运镜编排、微距构图,以及从原材料到最终揭晓的推进过程的参考。将原本的玻璃物件替换为 @image1 中的水晶狐狸雕塑。在整个序列中保留狐狸半透明的多面几何体、尖耳、卷曲的尾巴、水晶色泽和优雅比例。展示工匠在温暖的玻璃工坊中精心塑造水晶狐狸,配有真实的工具、发光的炉火、受控的反光与物理上合理的手部。将 @audio1 同时作为配乐和时间节奏指南。将炉火迸发与开场的低沉脉冲同步,将重要的工具接触与玻璃清鸣音效同步,将最终水晶狐狸的揭晓与最后一次闪烁的渐强同步。保持狐狸是无生命的玻璃雕塑,不要把它变成活的动物。保持同一个工坊、同一件雕塑和流畅的时间连续性。不得添加文字、标志、额外雕塑、变形的手或无关的场景变化。

@audio1(reference_audio_urls로 전달)은 여기서 명시적인 타임라인 트랙으로 사용됩니다. 프롬프트는 단순히 “음악”을 요구하는 것이 아니라 어떤 시각적 비트가 오디오의 어느 시점에 대응해야 하는지 모델에 알려 줍니다. 이런 수준의 지시가 있어야 동기화가 대략적인 근사가 아니라 명확하게 구분됩니다.

숏폼의 핵심 필드

  • reference_video_urls(필수, 배열) — 공개 영상 URL이 최소 하나 필요합니다. 동작, 카메라 경로, 리듬을 제공합니다. 위 세 예시 모두 정확히 하나만 사용합니다.
  • reference_image_urls(선택, 배열) — 예시 1처럼 참조 영상의 동작을 유지하면서 피사체를 교체합니다.
  • reference_audio_urls(선택, 배열) — 예시 3처럼 사운드, 음색, 또는 명시적 시간 동기화를 위한 참조 오디오입니다.
  • duration — 정수, 4~30초. 위 세 예시 모두 4초 하한을 사용했으며, 이는 숏폼 비트 하나를 담기에 충분합니다. 참조 영상의 총 길이 상한이 실제로 요청할 수 있는 길이를 결정합니다.
  • resolution — "480p", "720p", "1080p" 중 하나.
  • aspect_ratio — 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive 중 하나. TikTok/Reels라면 예시 1처럼 "9:16"으로 바로 설정하세요 — 별도 크롭 단계가 없습니다.

스키마는 엄격합니다: 이 목록 밖의 필드(seed, ratio, image_urls, audio_urls)는 생성 시작 전에 거부됩니다. 전체 요청/응답 구조와 오류 처리는 참조 기반 영상 생성 API 가이드를 참고하세요.

숏폼 요청 제출

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-<your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5/reference-to-video",
    "input": {
      "prompt": "Use @video1 for camera path and pacing only. Replace the subject with the product from @image1, keep lighting and framing consistent with the source.",
      "reference_video_urls": ["https://your-cdn.example.com/reference-clip.mp4"],
      "reference_image_urls": ["https://your-cdn.example.com/subject-ref.jpg"],
      "duration": 4,
      "resolution": "720p",
      "aspect_ratio": "9:16"
    }
  }'

즉시 taskId가 반환됩니다. GET /v1/tasks/{taskId}를 status가 "success"가 될 때까지 폴링하고, 만료되기 전에 output[0].url에서 다운로드하세요. 전체 인증 설정은 퀵스타트 문서, 이 모델의 파라미터 레퍼런스는 Seedance 2.5 문서 페이지를 참고하세요.

숏폼 배치 제작의 비용

현재 가격 데이터에서 720p는 초당 $0.2715 — 480p는 초당 $0.1215, 1080p는 초당 $0.68입니다. 과금되는 초 수는 참조 영상 길이에 출력 길이를 더한 값이므로, 5초 참조 클립에서 4초 출력을 생성하면 720p 기준 약 $2.44입니다. 참조 클립을 필요한 동작 구간만 남기도록 잘라 두세요. 숏폼 배치 테스트로 같은 참조 영상에서 여러 피사체 교체나 스타일 변형을 만들면 클립당 비용이 빠르게 쌓입니다 — 프롬프트를 반복 조정할 때는 테스트 길이를 4초 하한으로 유지하고, 참조 설정이 잡힌 뒤에 길이를 늘리세요.

자주 묻는 질문

참조 영상이 꼭 필요한가요, 참조 이미지만으로 시작할 수 있나요? reference_video_urls는 필수입니다 — 영상 URL이 최소 하나 필요합니다. reference_image_urls와 reference_audio_urls는 추가 레이어일 뿐 이를 대체하지 않습니다.

크롭 없이 진짜 9:16 출력을 얻을 수 있나요? 네 — 위 예시 1처럼 요청에 aspect_ratio: "9:16"을 설정하세요. 이 모델에서 실제로 지원되는 열거값이며 소스 클립 비율에 제약받지 않습니다.

오디오는 reference_audio_urls에서 오나요, 생성되나요? 둘 다 가능합니다. 위 예시 3은 명시적 @audio1 참조로 시간을 구동했고, 예시 1의 오디오는 별도 오디오 참조 없이 네이티브로 생성되었습니다. 기존 오디오 트랙과 특정 시간 동기화가 필요하다면 reference_audio_urls로 제공하고 프롬프트에서 명시적으로 인용하세요.

참조 영상은 얼마나 길어도 되나요? 참조 영상 입력 총 길이 상한은 30초이고, 출력 duration 상한도 30초입니다 — 이 모델은 긴 영상 소재가 아니라 짧은 클립을 위해 만들어졌습니다.

참조 입력을 더 많이 쓰면(영상 + 이미지 + 오디오) 더 비싼가요? 아니요 — 참조 이미지와 오디오는 비용을 추가하지 않습니다. 720p 요율은 초당 $0.2715이며 참조 영상 길이에 출력 길이를 더해 과금합니다.

이 기능으로 숏폼 파이프라인을 구축한다면 참조 기반 영상 생성 API 가이드가 콜백과 오류 처리를 포함한 전체 요청 수명 주기를 다루고, 모델 페이지는 스크립트를 작성하기 전에 참조 클립을 테스트할 수 있는 라이브 플레이그라운드를 제공합니다.

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

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

API 문서 보기