소개
Seedance 2.5 레퍼런스→영상은 외형, 움직임, 사운드트랙을 이끄는 자료로 새 시퀀스를 만듭니다. 캐릭터 이미지, 장소, 카메라 레퍼런스, 오디오 트랙이 각각 브리프의 다른 부분을 맡아야 할 때 고르는 모드입니다.
ByteDance는 2026년 7월 31일 출시 글에서 Seedance 2.5를 소개하며 유연한 레퍼런스 기반 제작을 핵심 기능으로 내세웠습니다. 이 엔드포인트는 그런 지시를 새 영상으로 엮기 위한 것이지, 보낸 사진을 첫 프레임으로 고정하기 위한 것이 아닙니다.
Seedance 2.5 시퀀스의 출발점 고르기
| 시작 자료 | 모드 |
|---|---|
| 대본이나 장면 설명 | Seedance 2.5 텍스트→영상 |
| 확정된 시작 이미지 | Seedance 2.5 이미지→영상 |
| 외형, 움직임, 오디오를 나눈 레퍼런스 | Seedance 2.5 레퍼런스→영상 |
핵심 기능 및 하이라이트
한 번의 생성으로 더 긴 이야기
Seedance 2.5는 최대 30초 클립을 지원해 시퀀스에 도입, 전개, 결말을 담을 여유가 있습니다. 서사 기능에는 동작 하나를 늘이는 것을 넘어 이어지는 샷과 장면 전환이 포함됩니다.
유연한 멀티모달 레퍼런스
이미지, 영상, 오디오가 같은 작품의 서로 다른 요소를 각각 이끌 수 있습니다. 확장된 레퍼런스 워크플로는 외형을 움직임과 소리에서 분리하면서 더 복잡한 캐스트, 배경, 샷 구성을 지원합니다.
클레이 렌더와 스토리보드 가이드
간단한 3D 기획 영상으로 공간 구조, 동선, 카메라 움직임을 전하고, 최종 룩은 이미지 레퍼런스로 제시할 수 있습니다. 스토리보드와 순서를 정한 키프레임도 시퀀스를 전달하는 방법이 됩니다.
더 섬세한 화면과 소리 연출
모델 개발은 재질, 조명, 피부와 눈의 디테일, 그리고 소리와 움직임의 조화를 중시합니다. 프롬프트에서 대사, 효과음, 앰비언스를 따로 지정하고 초 단위 타임스탬프로 사건을 정리할 수 있습니다.
부분 편집과 이어 만들기
이 모델 계열에는 시간을 지정한 영상 편집, 배경 교체, 기존 영상 이어 만들기가 포함됩니다. 이들은 영상을 입력하는 별도의 워크플로이며, 사용 가능 여부와 설정은 텍스트→영상이나 이미지→영상 요청이 아니라 선택한 작업에 따라 달라집니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수이고, 여기서는 캐스팅도 맡습니다. 레퍼런스는 보낸 순서대로 인용되니 어느 이미지가 어느 캐릭터인지, 각 클립이 무엇을 주는지, 오디오가 무엇을 위한 건지 적어 주세요. |
reference_image_urls | 아니요 | 레퍼런스 이미지 최대 30장이고 캐릭터나 스타일, 세트를 붙잡는 데 씁니다. 이전 세대는 9장뿐이었으니 여기선 여유가 꽤 생겼습니다. 30개 이하 |
reference_video_urls | 아니요 | 움직임과 호흡, 카메라 언어를 실어 주는 레퍼런스 클립 최대 10개입니다. 각각 2초에서 30초이고 합쳐 30초를 넘지 않습니다. 10개 이하 |
reference_audio_urls | 아니요 | 레퍼런스 오디오 파일 최대 10개이고 각각 2초에서 30초, 합쳐 30초를 넘지 않습니다(이전 세대는 파일 3개에 합계 15초였습니다). 말투나 템포, 음악 구절처럼 소리의 기준점을 줘서 움직임과 컷 지점이 거기에 맞춰지게 합니다. 10개 이하 |
aspect_ratio | 아니요 | 기본은 |
resolution | 아니요 | 480p, 720p, 1080p 중에서 고르고 기본은 720p이며 과금 대상에 직접 반영됩니다. 출력 구간만 정할 뿐 저해상도 레퍼런스를 선명하게 만들지는 않습니다. |
duration_seconds | 아니요 | 4초에서 30초까지이고 기본은 5입니다. 이 값과 레퍼런스 클립의 길이는 과금 대상에 각각 따로 더해지니, 둘 다 최대로 밀면 요청 하나가 비싸지는 지점입니다. |
generate_audio | 아니요 | 기본으로 켜져 있습니다. 화면에 싱크된 자체 사운드트랙을 만듭니다. 기본값: |
output_format | 아니요 | 반환되는 동영상의 컨테이너이며 mp4(기본값) 또는 mov를 고를 수 있습니다. 화면은 두 형식 모두 같습니다. |
enable_web_search | 아니요 | 기본값은 꺼짐입니다. 켜면 모델이 렌더링 전에 프롬프트와 관련된 정보를 웹에서 검색할 수 있습니다. 기본값: |
seed | 아니요 | 정수 seed입니다. 빼면 실행마다 알아서 뽑습니다. |
return_last_frame | 아니요 | 영상과 함께 클립의 마지막 프레임을 별도 이미지로 돌려줍니다. 다음 첫 프레임으로 image-to-video에 넘기면 정지 화면을 직접 뽑지 않고도 샷을 이어 붙일 수 있습니다. 기본값: |
watermark | 아니요 | 모델 문서에 적힌 대로, 영상에 AI 생성임을 나타내는 워터마크를 넣도록 요청합니다. 기본값은 꺼짐입니다. 기본값: |
요금
참조 클립의 길이도 과금 대상 초에 합산됩니다. 실행 전에는 클립 길이를 측정할 수 없어 우선 최대 30초분을 선점해 두었다가, 정산 시점에 사용하지 않은 금액을 즉시 돌려드립니다. 실제 사용된 초만 청구됩니다.
| 해상도 | With video: 예 | With video: 아니요 |
|---|---|---|
| $0.0738 / 초 | $0.1234 / 초 |
| $0.1659 / 초 | $0.2773 / 초 |
| $0.4082 / 초 | $0.6823 / 초 |
활용 사례
캐릭터, 세트, 카메라 계획 결합하기
사용 허가된 인물 이미지, 환경 레퍼런스, 원하는 움직임을 담은 짧은 클립을 준비하십시오. 정체성, 배치, 카메라 동작이라는 세 가지 기여를 따로 평가하십시오.
간단한 카메라 리허설을 스타일 있는 장면으로
움직임에는 간단한 기획 영상을, 재질과 조명에는 룩 레퍼런스를 쓰십시오. 기획 영상에서 무시할 부분을 설명하고, 생성된 형태가 정확하다고 가정하지 말고 공간 관계를 확인하십시오.
사용 허가된 오디오 트랙에 맞춰 영상 스케치하기
소리 레퍼런스를 올리고 함께할 영상, 분위기, 동작을 적으십시오. 음악이나 말소리의 신호와 화면 사이의 관계를 확인하십시오. 박자에 딱 맞는 편집이 보장되지는 않습니다.
프롬프트 가이드 및 실전 팁
Seedance 2.5에서 여러 레퍼런스를 지정하는 방법
이야기 앞에 자료 대응표를 분명히 적으십시오. 올린 이미지, 클립, 트랙 각각을 텍스트로 역할에 연결해야 하며, 레퍼런스 이미지 안에 이름이 적혀 있는 것만으로는 대응이 정해지지 않습니다.
- 영상 자료와 오디오 자료를 의도한 순서로 올립니다.
- 엔드포인트의 라벨
@Image1,@Video1,@Audio1을 씁니다. - 각 자료에서 무엇을 빌릴지 정확히 적습니다.
- 대응표 뒤에 장면 요약과 샷 순서 또는 타임스탬프를 적습니다.
배낭 이미지, 캠핑장 이미지, 카메라가 호를 그리는 클립이 있다면 12초를 고르십시오.
@Image1 supplies the backpack's design, straps and color.
@Image2 supplies the campsite and morning light.
Use only the camera arc from @Video1, not its subjects or background.
A backpack stands upright on a flat rock at the campsite.
0-4s: Establish the bag from the side; a loose strap moves gently in the breeze.
4-9s: Follow the reference camera arc toward the front of the bag.
9-12s: Stop the camera and hold on the front view.
Preserve the bag design while matching it to the campsite's light.
Sound: soft wind and distant birds, without music, dialogue or captions.
간단한 3D 카메라 리허설 쓰는 방법
클레이 렌더 클립을 영상 레퍼런스로 올리십시오. 카메라 경로, 피사체 움직임, 동선, 조명 중 무엇을 빌릴지 적으십시오. 완성된 피사체를 이미지로 제공한다면 리허설 속 대응하는 물체와 명시적으로 연결하십시오.
클립에서 편집기 오버레이, 좌표축, 카메라 가이드처럼 보이는 요소를 지우십시오. 레퍼런스의 역할뿐 아니라 완성된 장면도 설명하고, 요청한 동작이 리허설과 어긋나지 않게 하십시오.
스토리보드와 개별 키프레임 중 고르기
스토리보드 그리드는 전체 샷 순서를, 개별 이미지는 각 키프레임의 구도를 전할 수 있습니다. 그리드를 쓴다면 칸을 분명히 나누고 빠진 움직임과 소리는 프롬프트로 채우십시오. 개별 키프레임을 쓴다면 순서를 명시한 뒤 전환을 설명하십시오.
목소리와 동작을 모호함 없이 배정하기
캐릭터가 여럿이라면 각자에게 고정된 이름을 주고 외형과 목소리를 따로 연결하십시오. 오디오 트랙이 시퀀스를 이끈다면 @Audio1이 목소리, 리듬, 앰비언스 중 무엇을 제공하는지 적으십시오. 정확한 움직임 레퍼런스를 그와 어긋나는 단계별 동작으로 바꿔 쓰지 말고, 레퍼런스의 역할을 밝힌 뒤 빠진 정보만 더하십시오.
콘텐츠 범위
Seedance 2.5 · 레퍼런스→영상 — 무검열. SpicyAPI는 플랫폼 차원의 콘텐츠 필터를 추가하지 않습니다. 모델 자체의 제한은 여전히 적용되며 결과는 보장되지 않습니다. 저희 콘텐츠 정책을 준수할 책임은 사용자에게 있습니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.5/reference-to-video",
"input": {
"aspect_ratio": "adaptive",
"duration_seconds": 5,
"generate_audio": true,
"output_format": "mp4",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
