소개
video_url(최대 60초 클립)과 그다음에 일어날 일을 적은 프롬프트를 보냅니다. duration_seconds, resolution, generate_audio, last_image_url, watermark는 선택입니다. 플랫폼이 클립의 마지막 프레임을 꺼내 Flash 이미지→영상으로 이어지는 장면을 렌더하고 원본 뒤에 붙이며, 클립의 프레임 레이트와 원래 사운드트랙은 그대로 유지됩니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 제작사 | 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 | 예 | 필수입니다. 마지막 프레임 이후에 일어날 일만 적으십시오. 1자 이상 · 20000자 이하 |
video_url | 예 | 필수입니다. MP4, MOV 또는 WebM이며 길이는 60초, 긴 변은 3840픽셀까지입니다. 1자 이상 |
last_image_url | 아니요 | 선택입니다. 새 구간이 끝날 때 도달할 이미지로, 정해진 포즈나 구도에 도착해야 하는 샷에 씁니다. |
resolution | 아니요 | 새 구간의 해상도로 480p 또는 720p이며 기본값은 720p입니다. 초당 단가는 이 선택을 따릅니다. |
duration_seconds | 아니요 | 새 구간의 길이로, 4에서 30까지의 정수 초이며 기본값은 5입니다. 과금되는 것은 이 초뿐이며, 원본 영상은 이어 붙인 파일의 앞부분에 무료로 들어갑니다. |
generate_audio | 아니요 | 기본으로 켜져 있습니다. Flash가 프롬프트와 화면을 바탕으로 새 구간의 소리를 만들고, 이음매에서 원본 클립의 사운드와 크로스페이드합니다. 기본값: |
watermark | 아니요 | 기본으로 꺼져 있습니다. 켜면 모델이 새 구간에 보이는 AI 생성 표시를 넣습니다. 기본값: |
요금
새 구간만 Flash 이미지→영상 요청과 같은 방식으로 과금됩니다. 요청한 초마다 고른 해상도의 단가가 적용됩니다. 원본 클립과 이어 붙이는 처리에는 추가 요금이 없고, 사운드·종료 프레임·워터마크도 가격을 바꾸지 않으며, 실패한 연장에는 요금이 부과되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.115 / 초 |
| $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 영상 연장은 이미 가진 클립에 새 장면을 더합니다. SpicyAPI가 video_url의 마지막 프레임을 꺼내 프롬프트와 함께 Flash 이미지→영상에 첫 이미지로 넘기고, 완성된 4~30초 결과를 원본 끝에 이어 붙입니다. 처음부터 끝까지 한 번에 재생되는 MP4 한 개와 새 구간만 담은 파일을 받으며, 둘 다 480p 또는 720p에 사운드가 들어 있습니다.
요청 예시
POST https://api.spicyapi.ai/api/v1/jobs/createTask를 Authorization: Bearer YOUR_SPICY_API_KEY 헤더와 함께 호출합니다. 6초 클립에 5초를 더하는 예시입니다.
{
"model": "bytedance/seedance-2.5-flash/video-extend",
"input": {
"video_url": "https://example.com/cyclist.mp4",
"prompt": "The cyclist rests one foot on the curb, the light turns green, and she pushes off out of frame to the left while the camera holds still. Audio: idling traffic, a short bell ring.",
"duration_seconds": 5,
"resolution": "720p"
}
}
응답 예시
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "queued"}}
GET /api/v1/jobs/recordInfo?taskId=task_abc123을 폴링하거나 callBackUrl을 지정하십시오. output.assets에는 이어 붙인 클립(video)이 먼저, 새 부분(segment)이 그다음에 나오며, 실제 길이에는 소수점이 붙습니다.
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "succeeded", "output": {"assets": [{"url": "https://example.com/joined.mp4", "role": "video", "durationSeconds": 11.0}, {"url": "https://example.com/segment.mp4", "role": "segment", "durationSeconds": 5.0}]}}}
파라미터
| 파라미터 | 값 | 기본값 |
|---|---|---|
video_url | MP4, MOV, WebM, 60초까지 | 필수 |
prompt | 마지막 프레임 이후에 일어날 일 | 필수 |
duration_seconds | 4~30(새 구간) | 5 |
resolution | 480p, 720p | 720p |
generate_audio | true, false | true |
last_image_url | 새 구간이 끝나는 이미지 | 선택 |
watermark | 새 구간에 들어가는 모델 표시 | false |
새 구간은 클립 마지막 프레임의 형태를 따르고, 이어 붙인 파일은 언제나 MP4입니다.
과금 방식
새 구간의 요금은 Flash 이미지→영상 요청과 같아서, 요청한 초마다 해상도 단가가 적용됩니다. 원본 클립과 이어 붙이는 단계는 무료이며, 오디오나 종료 프레임, 워터마크를 써도 가격은 바뀌지 않습니다. 이어지는 장면 생성이나 이어 붙이기에 실패하면 전액 환불됩니다.
좋은 결과를 얻는 요령
- 원본은 선명하고 멈춘 프레임에서 끝내십시오. 마지막 프레임의 흔들림, 컷, 페이드는 새 구간으로 넘어가므로 깔끔한 순간에서 자르십시오.
- 장면이 아니라 다음에 일어날 일을 적으십시오. 누가 있고 어떻게 비치는지는 프레임이 이미 정합니다.
- 이어져야 할 움직임은 다시 적으십시오. 정지 화면에는 속도가 없으므로 ‘같은 속도로 계속 왼쪽으로 걷는다’처럼 쓰십시오.
- 소리를 계획하십시오. 원본의 공간음에 맞는
Audio:줄로 마무리하거나,generate_audio를 끄고 나중에 음악을 입히십시오.
제한과 오류
- 출력은 480p 또는 720p입니다. 1080p 원본도 받지만 새 부분은 그 화면에서 더 부드럽게 보입니다.
- 넘기는 것은 프레임 한 장뿐이어서 화면 밖에 있던 것, 카메라의 움직임, 사운드의 리듬은 이어지지 않으며, 이음매에서 조명이 조금 바뀔 수 있으니 이음매를 확인하십시오.
- 60초를 넘거나 긴 변이 3840픽셀을 넘는 원본, 읽을 수 없는 파일은 요금 없이 거절됩니다.
- 엔드포인트 전체 이름으로 호출하십시오. 패밀리 단위 호출에
video_url을 넣으면duration_seconds,last_image_url,watermark중 하나가 있을 때만 여기로 오고, 그렇지 않으면 영상 편집으로 실행됩니다. - 직접 권리를 가졌거나 사용 허락을 받은 영상만 연장하고, 실제 인물의 영상은 본인 동의 없이 이어 가지 마십시오.
플래그십 연장을 고를 때
Seedance 2.5 영상 연장은 1080p까지 렌더하고 프레임 한 장 대신 클립의 마지막 최대 30초를 읽으므로, 움직임이나 목소리가 끊기지 않고 이어져야 할 때 도움이 됩니다. 그 참조 초도 함께 과금됩니다.
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/video-extend",
"input": {
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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 레퍼런스에서 확인하세요.










