소개
프롬프트와 함께 reference_image_urls, reference_video_urls, reference_audio_urls 중 하나 이상을 보내십시오. 레퍼런스마다 장면에서 맡는 역할이 따로 있어, 인물, 제품, 카메라 움직임, 목소리를 각각 가져옵니다. 길이, 해상도, 화면비, 오디오는 선택입니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 영상 |
| 제작사 | ByteDance(Seedance 2.5 Flash, Seedance 2.5의 속도 티어, 2026년 11월 12일 BytePlus 발표) |
| API 이름 | bytedance/seedance-2.5-flash/text-to-video, image-to-video, reference-to-video, video-edit, video-extend |
| 해상도 | 480p 또는 720p(기본 720p), 1080p와 4K는 미지원 |
| 클립 길이 | 4 |
| 화면비 | 텍스트·레퍼런스 요청은 16:9(기본), 9:16, 4:3, 3:4, 1:1, 21:9, adaptive. 이미지→영상은 시작 이미지를 따름 |
| 레퍼런스 한도 | 레퍼런스→영상에서 이미지 최대 10장, 클립 5개(합계 30초), 오디오 파일 5개 |
| 레퍼런스 클립 규칙 | 클립당 최소 2초로 계산되며 약 409,600픽셀(854×480 이상) 필요 |
| 편집 입력 | 4~30초의 |
| 오디오 |
|
| 출력 옵션 | mp4(기본) 또는 mov. 워터마크는 기본 꺼짐. return_last_frame을 켜면 마지막 프레임 JPEG 추가 |
| 과금 기준 | 해상도별 초당 과금. 레퍼런스 클립은 그 초 수가 추가되고, 편집은 원본의 초 수 기준. 실패한 생성은 무료 |
| 측정된 렌더 시간 | 480p 4초 기준 84초~약 11분(2026년 11월 13일 실행) |
핵심 기능 및 하이라이트
상한이 낮아진 플래그십 워크플로
Flash는 초안 작업에 맞는 Seedance 2.5 워크플로 네 가지(텍스트, 시작·종료 프레임, 혼합 레퍼런스, 클립 편집)를 유지하고 1080p와 4K를 빼는 대신, 이미지→영상 모드를 바탕으로 한 영상 연장을 더합니다. BytePlus는 이 교환을 플래그십에 근접한 결과를 거의 2배 속도로 낸다고 소개합니다. 저희 4초 480p 렌더는 84초에서 약 11분까지 걸렸으니, 속도는 직접 쓰는 대기열에서 측정하십시오.
모든 업로드에 프롬프트 속 역할을 주십시오
업로드는 종류와 순서로, 공백을 넣어 부릅니다: @Image 1, @Video 1, @Audio 1. 인물 사진 두 장을 @Image 1과 @Image 2로 넣어 16:9로 만들었을 때는 두 사람이 한 엘리베이터 장면에 함께 나왔고 얼굴, 머리, 옷도 그대로였습니다. 이미지 한 장, 클립 하나, 음성 파일 하나를 넣었을 때는 클립의 거리, 노란 트램, 트래킹 카메라가 이어졌지만 인물은 등을 돌린 채였고 @Image 1의 얼굴은 거의 보이지 않았습니다.
화창한 거리가 눈 내리는 저녁으로
자전거를 탄 두 사람, 자전거, 트램, 카메라 움직임이 원본과 프레임 단위로 일치했고, 날씨와 빛만 바뀐 채 나머지는 그대로였습니다. 오디오를 끈 480p 4.0초 클립이었으며, 그 덕에 원본 사운드트랙도 그대로 남았습니다.
스위치 하나로 어떤 사운드트랙을 받을지 정합니다
generate_audio는 기본으로 켜져 있어 영상과 함께 음성, 효과음, 환경음을 만듭니다. 영상 편집에서 끄면 원본 클립의 트랙이 유지되고(저희 테스트에서는 44.1kHz), 켜면 @Audio 1을 따를 수 있는 새 트랙이 생성됩니다. 이 스위치는 가격에 영향을 주지 않습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 업로드마다 종류와 번호를 공백으로 이어 @Image 1, @Image 2, @Video 1, @Audio 1처럼 부르고, 인물, 제품, 카메라 움직임, 목소리 중 하나의 역할을 주십시오. 번호는 종류별로 셉니다. 1자 이상 · 20000자 이하 |
reference_image_urls | 아니요 | 유지하고 싶은 인물, 제품, 장소, 분위기를 담은 이미지 최대 10장입니다. 피사체마다 선명하고 밝은 사진 한 장을 보내고 프롬프트에서 이름을 불러 주십시오. 1개 이상 · 10개 이하 |
reference_video_urls | 아니요 | 클립 최대 5개, 합계 30초이며 각각 약 409,600픽셀 이상이어야 합니다. 854×480과 1280×720은 통과했고 640×360 클립은 제출 단계에서 거부되었습니다. 1개 이상 · 5개 이하 |
reference_audio_urls | 아니요 | 음성, 음악, 효과음 파일 최대 5개, 합계 30초입니다. 프롬프트에서 예를 들어 ‘in the voice from @Audio 1’처럼 가리키십시오. 1개 이상 · 5개 이하 |
aspect_ratio | 아니요 | 16:9(기본), 9:16, 4:3, 3:4, 1:1, 21:9 또는 모델이 형태를 고르는 adaptive입니다. 저희 이미지 두 장 9:16 테스트는 480×854로 돌아왔습니다. |
resolution | 아니요 | 480p 또는 720p이며 기본값은 720p입니다. Flash의 해상도 상한은 720p입니다. |
duration_seconds | 아니요 | 4에서 30까지의 정수 초이며 기본값은 5입니다. 요청한 초는 첨부한 클립의 초와 별도로 더해서 과금되므로, 짧은 장면에 짧은 클립을 쓰면 초안 비용이 작게 유지됩니다. |
generate_audio | 아니요 | 기본값은 켜짐이라 장면에 동기화된 음성, 효과음, 환경음이 붙으며, 첨부한 오디오 파일은 그 소리를 이끄는 용도입니다. 끄면 같은 가격에 무음 파일을 받습니다. 기본값: |
output_format | 아니요 | mp4(기본) 또는 mov입니다. 편집기가 기대하는 컨테이너를 고르십시오. |
return_last_frame | 아니요 | 기본값은 꺼짐입니다. 켜면 마지막 프레임을 JPEG로도 돌려주며, 이를 이미지→영상 후속 샷의 시작 프레임으로 써서 같은 출연진을 이어 갈 수 있습니다. 기본값: |
watermark | 아니요 | 기본값은 꺼짐입니다. 켜면 모델이 프레임에 보이는 워터마크를 넣으며, 직접 가진 레퍼런스로 만든 초안이 외부로 돌 때 쓸 만합니다. 기본값: |
요금
480p 또는 720p 단가로 초 단위 과금합니다. 레퍼런스 클립을 붙이면 그 초 수(클립당 최소 2초)가 요청한 초에 더해지고, 합계 전체에 클립 포함용 낮은 단가가 적용됩니다. 레퍼런스 이미지와 오디오 파일, 오디오 켬/끔, 화면비, 워터마크, 마지막 프레임, 형식은 가격에 영향을 주지 않으며 실패한 생성에는 요금이 부과되지 않습니다.
| 해상도 | With video: 예 | With video: 아니요 |
|---|---|---|
| $0.0706 / 초 | $0.115 / 초 |
| $0.147 / 초 | $0.2392 / 초 |
활용 사례
최종 렌더 전에 샷 계획 시험하기
비 내리는 밤의 횡단보도 같은 장면을 ‘Audio:’ 줄로 마무리한 4초·480p·16:9 프롬프트로 보냅니다. 저희 실행은 24fps의 854×480, 길이 4.064초에 빗소리와 웃음소리가 담긴 AAC 스테레오 트랙을 돌려주었습니다. 한 구절만 바꿔 다시 돌리면 무엇이 달라졌는지 바로 보입니다.
촬영해 둔 영상의 분위기 바꾸기
4~30초 클립을 올리고 바꿀 내용을 설명한 뒤, 그대로 둘 것을 나열합니다. 저희 테스트에서는 자전거를 탄 두 사람과 트램이 있는 화창한 거리가 눈 내리는 저녁으로 바뀌었고, generate_audio를 끄자 원본 사운드트랙이 그대로 돌아왔습니다.
캐릭터와 제품 목업
인물 사진과 제품 사진을 @Image 1, @Image 2로 붙이고 9:16을 요청합니다. 저희 이미지 두 장 테스트는 남성이 유리 스포이트 병을 렌즈 쪽으로 들어 올리는 480×854 영상을 돌려주어 두 레퍼런스가 모두 반영되었습니다. 완성도 높은 버전을 만들기 전에 이 결과로 아이디어를 가늠해 보십시오.
인물 애니메이션 루프
같은 사진을 image_url과 last_image_url에 넣고 둘 사이의 움직임을 설명합니다. 저희 도예가 초상 테스트는 시작 프레임과 마지막 프레임이 모두 원본 포즈와 일치하는 562×748, 4.064초 클립을 돌려주었습니다.
한 샷에서 다음 샷으로 이어 가기
return_last_frame을 true로 두면 MP4와 함께 마지막 프레임의 JPEG가 도착합니다(저희 테스트에서는 480p 16:9에서 854×480). 이 JPEG를 다음 이미지→영상 요청의 image_url로 넘기면 다음 샷이 앞 샷이 멈춘 자리에서 시작됩니다.
프롬프트 가이드 및 실전 팁
입력에 맞는 엔드포인트 고르기
프롬프트만 있으면 텍스트→영상, 시작 프레임이 있으면 이미지→영상, 이미지·클립·목소리를 쓰려면 레퍼런스→영상, 이미 있는 4
30초 클립을 고치려면 영상 편집을, 최대 60초 클립에 430초를 더하려면 영상 연장을 씁니다. 다섯 가지 모두 480p/720p 범위와generate_audio스위치를 공유합니다.createTask 요청 보내기
https://api.spicyapi.ai/api/v1/jobs/createTask로 POST합니다. 헤더는 Authorization: Bearer YOUR_SPICY_API_KEY, 본문은 {"model": "bytedance/seedance-2.5-flash/text-to-video", "input": {"prompt": "A lighthouse keeper climbs a spiral stair at dawn and wipes fog from the lamp glass. Audio: wind, boots on iron.", "
duration_seconds": 4, "resolution": "480p"}}입니다.완성된 클립 조회하기
응답에는 상태가 queued인 taskId가 담겨 있습니다. GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID를 호출하거나 callBackUrl을 지정해 상태가 succeeded가 될 때까지 기다린 뒤, output.assets에서 MP4 주소를 읽으십시오. 필드 상세는 docs.spicyapi.ai/docs/tasks의 작업 가이드에 있습니다.
한 구절만 바꾸고, 그다음 올리기
480p, 4초에서 실행마다 한 구절만 바꿔 가며 변형을 비교합니다. 마음에 드는 테이크가 나오면 720p와 목표 길이로 다시 돌리거나, 1080p가 필요하면 같은 브리프를 Seedance 2.5로 보내십시오.
Seedance 2.5 Flash 레퍼런스→영상이 하는 일
Seedance 2.5 Flash 레퍼런스→영상은 Seedance 2.5의 Flash 티어를 위한 ByteDance의 다중 레퍼런스 엔드포인트입니다. 이미지 최대 10장, 영상 클립 5개, 오디오 파일 5개를 붙이면, 프롬프트가 각각 무엇을 더하는지 정해 480p 또는 720p의 4~30초 새 장면을 사운드와 함께 만듭니다.
레퍼런스는 인물, 제품의 외형, 카메라의 움직임, 목소리를 공급할 뿐 어느 것도 첫 프레임이 되지는 않습니다. 정확히 한 장의 사진으로 시작해야 하는 샷은 이미지→영상에 맞습니다. ByteDance의 클라우드 플랫폼인 BytePlus는 Flash를 ‘플래그십 Seedance 2.5에 근접한 결과를 거의 2배의 생성 속도로’ 내는 모델로 소개하며, 480p와 720p만 지원합니다.
요청 예시
Authorization: Bearer YOUR_SPICY_API_KEY 헤더와 함께 POST https://api.spicyapi.ai/api/v1/jobs/createTask로 아래 본문을 보내십시오(작업 API 가이드). 종류마다 목록 순서대로 따로 번호가 붙습니다. 인물 사진은 @Image 1, 클립은 @Video 1, 음성 파일은 @Audio 1입니다.
{
"model": "bytedance/seedance-2.5-flash/reference-to-video",
"input": {
"prompt": "The man from @Image 1 walks past the vintage car at the roadside gas station from @Video 1, filmed with the same slow camera move. He stops by the pump, looks into the lens and says a short friendly greeting in the voice from @Audio 1.",
"reference_image_urls": ["https://example.com/man-portrait.jpg"],
"reference_video_urls": ["https://example.com/gas-station-1280x720.mp4"],
"reference_audio_urls": ["https://example.com/greeting-voice.mp3"],
"duration_seconds": 4,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}
응답 예시
제출하면 {"code": 200, "msg": "success", "data": {"taskId": "YOUR_TASK_ID", "state": "queued"}}가 돌아옵니다. GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID를 폴링하거나 callBackUrl을 지정하십시오. 완료된 작업은 다음과 같습니다.
{"code": 200, "msg": "success", "data": {"taskId": "YOUR_TASK_ID", "state": "succeeded", "output": {"assets": [{"url": "https://example.com/seedance-flash-reference.mp4"}]}}}
파라미터
| 파라미터 | 값 |
|---|---|
prompt | 필수. 업로드를 @Image 1, @Video 1, @Audio 1로 부름 |
reference_image_urls | 이미지 최대 10장 |
reference_video_urls | 클립 최대 5개, 합계 30초, 각각 약 409,600픽셀 이상 |
reference_audio_urls | 오디오 파일 최대 5개, 합계 30초 |
duration_seconds | 4~30, 기본 5 |
resolution | 480p 또는 720p, 기본 720p |
aspect_ratio | 16:9(기본), 9:16, 4:3, 3:4, 1:1, 21:9, adaptive |
generate_audio, watermark, return_last_frame, output_format | 기본값은 true, false, false, mp4(mov도 가능) |
이미지, 클립, 오디오 파일 중 하나 이상을 보내십시오. 이 엔드포인트에는 image_url 필드가 없습니다.
과금 방식
선택한 해상도의 단가로 초 단위 과금합니다. 레퍼런스 클립이 없으면 과금 길이는 요청한 초입니다.
클립을 붙이면 요청한 초에 모든 클립의 초(클립당 최소 2초)를 더한 길이가 더 낮은 초당 단가로 과금됩니다. 이 페이지의 가격에 두 단계가 모두 표시되니, 클립은 필요한 구간만 잘라 쓰십시오. 이미지, 오디오 파일, 오디오 스위치, 화면비, 워터마크, 마지막 프레임, 형식은 가격에 영향을 주지 않습니다. 실패한 생성에는 요금이 부과되지 않습니다.
좋은 결과를 얻는 요령
레퍼런스마다 역할을 주십시오. 이름만 붙여 두면 모델이 짐작에 맡기게 됩니다.
| 이름 | 역할 | 저희가 쓴 표현 |
|---|---|---|
@Image 1 | 인물 | ‘The man from @Image 1’ |
@Image 2 | 제품 | ‘the glass dropper bottle from @Image 2’ |
@Video 1 | 카메라 움직임 | ‘filmed with the same slow camera move’ |
@Audio 1 | 목소리 | ‘in the voice from @Audio 1’ |
이름은 저희 예시의 형태대로 @Image 1처럼 공백을 넣어 쓰십시오. 번호는 종류별로 셉니다. 이미지가 몇 장이든 영상 목록의 맨 위 클립이 @Video 1입니다.
얼굴을 요청하십시오. 한 테스트에서 인물 사진, 4초 클립, 오디오 파일을 넣었더니 클립의 거리, 노란 트램, 트래킹 카메라는 이어졌지만 인물은 등을 돌린 채였고 @Image 1의 얼굴은 거의 보이지 않았습니다. 주유소 예시의 ‘looks into the lens’처럼 얼굴이 어디를 향할지 적으십시오.
클립이 무엇을 가져오는지 정하십시오. 그 테스트에서는 카메라 움직임과 함께 배경도 따라왔습니다. 움직임만 가져오고 싶다면 그렇게 쓰십시오.
저희 테스트 결과
모두 2026년 11월 13일, 480p, 4초, 오디오 켬 조건입니다.
| 레퍼런스 | 결과 | 소요 시간 |
|---|---|---|
| 인물 사진, 5.04초 1280×720 클립, 음성 파일 | 854×480, 4.064초. 남성이 빈티지 자동차 옆을 지나 렌즈를 보며 미소 지음 | 2.5분 |
| 이미지 2장(남성, 스포이트 병), 9:16 | 480×854. 남성이 병을 들어 카메라 쪽으로 돌렸고 두 레퍼런스를 모두 사용 | 5.4분 |
| 인물 사진, 4초 클립, 오디오 파일 | 거리, 트램, 카메라는 유지됨. 인물은 등을 돌린 채 | 9.4분 |
Flash 네 엔드포인트 전체에서 4초 480p 클립은 84초에서 약 11분이 걸렸고, 720p나 더 긴 클립은 더 오래 걸립니다. Flash만 놓고 잰 이 시간은 BytePlus가 Seedance 2.5와 비교해 한 설명을 확인하지도 반박하지도 않습니다.
제한과 오류
| 제한 | 일어나는 일 | 대응 |
|---|---|---|
| 이미지 10장, 클립 5개, 오디오 파일 5개 초과 또는 클립 합계 30초 초과 | 검증 실패 | 역할이 있는 레퍼런스만 남기고 클립을 자르십시오 |
| 약 409,600픽셀 미만의 클립 | createTask가 제출 단계에서 거부되고 렌더는 시작되지 않음. 저희 640×360 클립(230,400픽셀)이 거부됨 | 854×480이나 1280×720 이상으로 다시 내보내십시오. 세로 480×854 클립도 통과합니다 |
권리를 가진 얼굴, 음성, 영상만 사용하고, 생성한 인물을 실존 인물인 것처럼 내세우지 마십시오. 모델은 자체 저작권·초상 검사를 거치며 요청을 거절할 수 있습니다.
다른 엔드포인트를 고를 때
- Flash 이미지→영상: 정확히 한 장의 사진으로 샷을 열어야 할 때.
- 프롬프트만 있다면 Flash 텍스트→영상, 기존 클립을 바꾸려면 Flash 영상 편집.
- Seedance 2.5: 720p를 넘는 납품, 4K, 클립 연장.
- Seedance 2.0 Fast: 연장 기능이 있는 이전 세대 고속 티어.
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-flash/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"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 레퍼런스에서 확인하세요.










