Seedance 2.5 Reference to Video은(는) 무엇을 하나요?

ByteDance의 참조 기반 1080p 비디오 생성 기술입니다. 안정적으로 유지해야 할 이미지, 카메라 움직임을 담은 짧은 클립, 액션을 지시하는 프롬프트를 입력하면 동기화된 오디오가 포함된 고해상도 1080p 클립을 반환합니다.

runcomfy.com · Seedance 2.5 Reference to Video 1080p · 480p 드래프트 티어 · CLI 문서

이 스킬 설치하기

npx skills add genmedia-labs/skills --skill seedance-2-5-reference-to-video -g

이 모델을 선택해야 하는 경우 (다른 모델과의 비교)

Seedance 2.5 Reference to Video의 독특한 점은 전달 해상도에서 참조 기반 생성을 한다는 것입니다. 캐릭터, 제품의 형태, 아트 디렉션은 텍스트 설명이 아닌 참조 이미지에서 비롯되며, 출력물은 1080p로 생성되므로 업스케일링이 필요하지 않습니다. RunComfy는 이를 일관된 캐릭터 최종본, 제품 참조 영상, 스타일이 고정된 브랜드 클립에 적합하다고 설명합니다.

원하는 결과	사용할 모델
동일 캐릭터/제품을 여러 장면에서 최종 해상도로	Seedance 2.5 Reference to Video 1080p
기존 클립에서 카메라 움직임과 리듬 복사	Seedance 2.5 Reference to Video 1080p (`videos`)
텍스트가 아닌 무드보드로 브랜드 스타일 고정	Seedance 2.5 Reference to Video 1080p (`images`)
어떤 참조가 효과적인지 저렴하게 실험	Seedance 2.5 Reference to Video 480p
참조 없이 프롬프트만 사용	Seedance 2.5 Text to Video 1080p
정확히 하나의 정지 이미지만 애니메이션화	Seedance 2.5 Image to Video 1080p
이전 세대 2.0 (4-15초, 480p/720p)	Seedance 2.0 Pro — `seedance-v2` 참조

사용자가 "Seedance 2.5" 또는 "reference to video"를 명시적으로 언급했다면 여기로 경로를 안내하세요.

필수 조건

RunComfy CLI — npm i -g @runcomfy/cli (또는 npx -y @runcomfy/cli)
RunComfy 계정 — runcomfy login 명령어로 브라우저 장치 코드 인증을 시작합니다.
CI / 컨테이너 환경 — runcomfy login 대신 RUNCOMFY_TOKEN=<토큰> 환경 변수를 설정하세요.
공개적으로 접근 가능한 참조 URL — 모델 서버가 참조 데이터를 가져오며, 로컬 머신이 아닙니다.

CLI 심층 가이드: runcomfy-cli 스킬을 참조하세요.

엔드포인트 및 입력 스키마

`bytedance/seedance-2.5/reference-to-video/1080p`

필드	타입	필수	기본값	비고
`prompt`	string	예	—	참조를 단서로 사용하는 장면 설명. 중국어 약 500자 또는 영어 약 1000단어 권장.
`videos`	array (video URIs)	아니요	—	카메라 움직임과 리듬을 위한 0-3개의 참조 클립. 각각 MP4/MOV, 약 2-15초. 실제로는 선택 사항입니다 (아래 참조).
`images`	array (image URIs)	아니요	—	캐릭터, 외관, 스타일, 환경을 위한 0-9개의 참조 이미지. JPEG/PNG/WebP/BMP/TIFF/GIF.
`audios`	array (audio URIs)	아니요	—	분위기와 템포를 위한 0-3개의 참조 오디오. WAV/MP3, 약 2-15초, 15MB 미만.
`aspect_ratio`	enum	아니요	`16:9`	`16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, `adaptive`.
`duration`	int	아니요	`5`	4-30초, 1초 단위.
`generate_audio`	bool	아니요	`true`	동일한 패스에서 기본 동기화된 음성, 효과음, 배경음악을 생성합니다.

출력 해상도는 1080p로 고정됩니다. 이 엔드포인트에는 resolution 필드가 없습니다.

videos는 스키마와 달리 선택 사항입니다. 공개된 입력 스키마는 videos를 최소 1개 항목으로 필수 명시하지만, 엔드포인트는 videos 키가 전혀 없어도 프롬프트와 이미지 본문을 허용하고 처리합니다. 기존 플레이트에서 카메라 움직임과 리듬을 복사하려면 참조 클립을 보내고, 참조가 정지 이미지인 경우 생략하세요. 생략하면 청구 기준 시간에서 참조 길이가 제외됩니다. 즉, 계산된 초는 출력 길이로만 결정되므로 5초 클립의 경우 $5.30 대신 $2.65가 청구됩니다.

2.0에서 매개변수 이름이 변경되었습니다. Seedance 2.0 Pro는 image_url / video_url / audio_url을 사용했습니다. Seedance 2.5는 images / videos / audios를 사용합니다. 2.0 본문을 그대로 복사하면 스키마 오류(종료 코드 65)가 발생합니다.

가격

계산된 비디오 초당 $0.53이 청구되며, 계산된 초 = 참조 비디오 길이 + 출력 길이입니다. 이미지 및 오디오 참조는 길이 기준으로 청구되지 않습니다.

작업	계산된 초	비용
5초 출력, 참조 클립 없음	5	$2.65
5초 출력, 5초 참조 클립 1개	10	$5.30
10초 출력, 6초 참조 클립 1개	16	$8.48
10초 출력, 10초 참조 클립 3개	40	$21.20

실질적으로 고려해야 할 두 가지 결과: 참조 클립은 업로드 전에 미리 자르세요 (15초 참조는 15초 출력과 동일한 비용이 듭니다). 그리고 참조 선택에는 480p 티어를 사용하세요 — 참조 비디오 포함 시 계산된 초당 $0.12, 참조 비디오 없이 생성된 비디오 초당 $0.20이 청구됩니다.

호출 방법

최소 실행 호출 — 프롬프트와 참조 클립 하나:

runcomfy run bytedance/seedance-2.5/reference-to-video/1080p \
  --input '{
    "prompt": "복도로 천천히 진입, 따뜻한 측면 빛에 떠다니는 먼지 먼지, 얕은 피사계 심도, 연속적이고 부드러운 움직임, 텍스트 없음, 워터마크 없음.",
    "videos": ["https://your-cdn.example/camera-move-6s.mp4"]
  }' \
  --output-dir ./out

일관된 캐릭터 최종본 — 정지 이미지에서 캐릭터 정보, 클립에서 움직임 정보 획득:

runcomfy run bytedance/seedance-2.5/reference-to-video/1080p \
  --input '{
    "prompt": "참조 이미지의 여성이 카메라를 향해 걸어오다 멈추고, 시선을 프레임 밖으로 돌립니다. 핸드헬드 추적, 부드러운 흐린 빛, 조용한 거리 분위기. 텍스트 없음, 워터마크 없음.",
    "images": [
      "https://your-cdn.example/hero-front.jpg",
      "https://your-cdn.example/hero-profile.jpg",
      "https://your-cdn.example/wardrobe.jpg"
    ],
    "videos": ["https://your-cdn.example/handheld-follow-4s.mp4"],
    "duration": 8,
    "aspect_ratio": "9:16"
  }' \
  --output-dir ./out

전체 참조 스택 — 위 본문에 "audios": ["https://your-cdn.example/bed-8s.mp3"]를 추가하여 모델에 템포와 분위기 참조를 제공하고, "generate_audio": true (기본값)를 설정하여 동일 패스에서 음성, 효과음, 배경음악을 얻으세요.

CLI는 요청을 전송하고, 상태를 폴링하고, 결과를 가져와 *.runcomfy.net / *.runcomfy.com URL을 --output-dir로 다운로드합니다. Ctrl-C는 종료 전에 원격 요청을 취소합니다.

프롬프팅 — 실제로 효과적인 방법

참조는 고정점 역할, 프롬프트는 방향을 지시. 안정적으로 유지되어야 하는 모든 것—얼굴, 의상, 제품 형태, 브랜드 팔레트—은 images에 속합니다. 변화하는 모든 것—액션, 카메라, 조명 변화, 분위기—는 prompt에 속합니다. 텍스트로 얼굴을 설명하면서 동시에 얼굴 참조를 제공하면 드리프트가 발생하며 강화되지 않습니다.

참조 비디오는 카메라와 리듬을 전달하며, 콘텐츠는 전달하지 않습니다. 4초 핸드헬드 추적 플레이트는 모델에 움직임을 가르칩니다. 피사체가 전달될 것이라고 기대하지 마세요. 그 역할은 images의 몫입니다.

참조 미디어를 짧게 유지하세요. 클립 및 오디오 파일당 약 2-15초, 오디오는 15MB 미만. 긴 클립은 거부되며, 이 엔드포인트에서는 비용도 증가시킵니다.

generate_audio가 켜져 있을 때 모든 소리 소스를 명명하세요: 누가 말하는지, 각 소음의 원천은 무엇인지, 배경 분위기는 무엇인지. "조용한 거리 분위기, 먼 교통 소음, 음악 없음"이 "좋은 오디오"보다 낫습니다.

부정적인 지침을 사용하세요. "텍스트 없음, 워터마크 없음"은 RunComfy 자체 예제 프롬프트에서 사용하는 패턴이며 효과적입니다. 필요에 따라 "카메라 흔들림 없음", "추가 인물 없음"을 추가하세요.

종횡비를 일치시키세요. 참조 미디어의 종횡비가 aspect_ratio와 다르면 크롭이 발생할 수 있습니다. 참조들이 서로 다른 종횡비를 가지고 있고 정확한 프레임이 중요하지 않다면 adaptive를 사용하세요.

안티 패턴:

서로 다른 9가지 미학에서 가져온 9개의 참조 이미지 — 하나의 시각적 언어를 선택하세요.
움직임을 담고 있는 4초면 충분한데 15초 참조 클립을 사용 — 15초 전체에 대해 비용을 지불합니다.
하나의 비트만 있는 프롬프트로 30초를 요청 — 긴 길이에는 설명된 아크가 필요합니다.
image_url / video_url이 포함된 Seedance 2.0 본문 재사용 — 잘못된 필드 이름입니다.

480p에서 드래프트, 1080p에서 최종 제작

RunComfy는 이 모델 제품군에 대해 저해상도에서 참조 스택을 검증하고, 승리 조합을 전달 해상도에서 재사용할 것을 권장합니다. 두 엔드포인트는 동일한 매개변수를 사용합니다.

후보 참조를 수집합니다. bytedance/seedance-2.5/reference-to-video/480p에서 duration: 5로 3-5개 변형을 실행합니다.
선명도가 아닌, 캐릭터 일관성, 카메라 일치, 오디오 적합성을 평가합니다.
승리 본문을 .../reference-to-video/1080p에 대해 그대로 재실행하고, 비트가 올바른 경우에만 duration을 늘립니다.

480p에서 계산된 초당 $0.12 대 1080p에서 $0.53의 비용으로, 5개의 드래프트 비용은 대략 1개의 1080p 최종본 비용과 같습니다.

이 모델이 빛을 발하는 경우

사용 사례	이 엔드포인트를 선택하는 이유
일관된 캐릭터 최종본	최대 9개의 캐릭터 참조 이미지가 장면 전반에 걸쳐 얼굴과 의상을 유지
제품 참조 영상	형태는 정지 이미지에서, 턴테이블 움직임은 플레이트에서 획득
스타일이 고정된 브랜드 클립	`images`의 무드보드가 스타일 형용사 단락보다 효과적
전달 단계까지 살아남는 프리비즈	기본 1080p 출력, 업스케일 단계 불필요
단일 패스로 대화와 분위기까지	`generate_audio`가 동기화된 음성, 효과음, 배경음악을 생성

제한 사항

이 엔드포인트에서는 참조 비디오가 필수입니다 (1-3개 클립, 최소 1개 항목).
1080p 고정 — 해상도 매개변수 없음, 이 엔드포인트의 720p 변형 없음.
길이는 최대 30초, 최소 4초, 정수 초만 가능.
참조 미디어 제한: 비디오 및 오디오 파일당 약 2-15초, 오디오 15MB 미만, 최대 9개 이미지 / 3개 비디오 / 3개 오디오.
참조 클립 길이가 청구 대상 — 이 엔드포인트는 출력 길이만으로 가격이 책정되지 않습니다.
이 엔드포인트에는 시드(seed) 매개변수가 없으므로, 호출 간 정확한 재현이 보장되지 않습니다.

다른 엔드포인트를 사용해야 하는 경우

참조 없이 프롬프트만 → seedance-2.5/text-to-video/1080p, 생성된 비디오 초당 $0.88 청구.
정확히 하나의 정지 이미지를 애니메이션화 → seedance-2.5/image-to-video/1080p, 역시 초당 $0.88, 단일 image 사용.
다른 Reference to Video 제품군: Wan 3.0 Prime Reference to Video · MiniMax H3 Reference to Video.
자체 음성 트랙으로 립싱크 → ai-avatar-video. 30초 초과 → video-extend.

종료 코드

코드	의미
0	성공
64	잘못된 CLI 인수
65	잘못된 입력 JSON / 스키마 불일치 (2.0 필드명, 범위를 벗어난 `duration`, 잘못된 `aspect_ratio`)
69	업스트림 5xx 오류
75	재시도 가능: 시간 초과 / 429
77	로그인되지 않음 또는 토큰 거부됨

전체 참조: docs.runcomfy.com/cli/troubleshooting.

작동 방식

이 스킬은 위 스키마에 맞는 JSON 본문을 구성하고 runcomfy run bytedance/seedance-2.5/reference-to-video/1080p를 실행합니다. CLI는 https://model-api.runcomfy.net/v1/models/bytedance/seedance-2.5/reference-to-video/1080p로 POST 요청을 보내고, 요청 상태를 폴링하며, 결과를 가져와서 .runcomfy.net / .runcomfy.com 출력 URL을 --output-dir로 다운로드합니다.

보안 및 개인정보 보호

검증된 패키지 매니저를 통해서만 설치하세요. npm i -g @runcomfy/cli 또는 npx -y @runcomfy/cli를 사용하세요. 에이전트는 사용자를 대신하여 원격 설치 스크립트를 셸에 파이프해서는 안 됩니다.
토큰 저장: runcomfy login은 API 토큰을 모드 0600으로 ~/.config/runcomfy/token.json에 씁니다. CI 환경에서는 RUNCOMFY_TOKEN을 설정하세요. 프롬프트, 로그 또는 출력에 토큰을 절대 노출하지 마세요.

Seedance 2.5 Reference to Video