소개
image_url과 prompt를 보내 정지 이미지를 움직이게 합니다. last_image_url, duration_seconds, resolution, generate_audio는 선택이고, watermark, return_last_frame, output_format은 부가 옵션입니다. 클립이 시작 이미지의 형태를 유지하므로 aspect_ratio 필드는 없습니다. 프롬프트에서는 사진을 다시 묘사하지 말고 움직임, 카메라, 사운드를 쓰십시오.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 영상 |
| 제작사 | 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자 이하 |
image_url | 예 | 필수입니다. 클립은 이 사진에서 시작하고 비율도 사진을 따릅니다. |
last_image_url | 아니요 | image_url과 함께 보내는 선택 종료 프레임입니다. 루프나 처음 포즈로의 복귀에는 도예가 예시처럼 시작 사진을 그대로 다시 넣고, A에서 B로 가는 움직임에는 구도와 빛이 맞는 관련 사진을 넣으십시오. |
resolution | 아니요 | 480p 또는 720p이며 기본값은 720p입니다. 선택에 따라 초당 단가가 달라집니다. |
duration_seconds | 아니요 | 4에서 30까지의 정수 초이며 기본값은 5이고, 요청한 초는 모두 과금됩니다. 설명한 동작에 길이를 맞추십시오. |
generate_audio | 아니요 | 기본값은 켜짐입니다. Audio: 줄과 사진을 바탕으로 같은 패스에서 사운드가 생성됩니다. 기본값: |
output_format | 아니요 | mp4(기본) 또는 mov입니다. 편집기나 플레이어가 기대하는 컨테이너를 고르십시오. |
return_last_frame | 아니요 | 기본값은 꺼짐입니다. 켜면 마지막 프레임을 JPEG로도 받아, 다음 호출의 image_url로 보내 샷을 이어 갈 수 있습니다. 기본값: |
watermark | 아니요 | 기본값은 꺼짐입니다. 켜면 모델이 프레임에 보이는 워터마크를 넣으며, 검토용 사본 같은 곳에 쓸 수 있습니다. 기본값: |
요금
요청한 초 기준으로 과금하며, 단가는 고른 해상도에 따라 정해집니다. 종료 프레임, 오디오 스위치, 워터마크, 마지막 프레임 이미지, 파일 형식은 가격에 영향을 주지 않고, 실패한 생성에는 요금이 부과되지 않습니다.
| 사양 | 요금 |
|---|---|
| $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 이미지→영상은 Seedance 2.5 속도 티어에서 사진 한 장을 움직이게 하는 ByteDance의 방식입니다. 사진을 image_url로, 무엇이 움직여야 하는지를 적은 프롬프트와 함께 보냅니다. 모델은 사진에서 시작하는 4~30초 MP4를 480p 또는 720p로 돌려주며, 소리는 같은 패스에서 생성됩니다. last_image_url을 더하면 클립이 두 번째 사진에서 끝나므로 루프, 포즈 복귀, A에서 B로의 전환을 다룰 수 있습니다(흔히 첫 프레임·마지막 프레임 영상으로 검색되는 방식). ByteDance의 클라우드 플랫폼인 BytePlus는 Flash가 Seedance 2.5에 근접한 결과를 거의 2배의 생성 속도로 낸다고 설명합니다.
요청 예시
POST https://api.spicyapi.ai/api/v1/jobs/createTask를 Authorization: Bearer YOUR_SPICY_API_KEY, Content-Type: application/json 헤더와 함께 호출합니다. 아래 본문은 저희 도예가 테스트로, 초상 한 장을 시작 프레임과 종료 프레임으로 모두 썼습니다.
{
"model": "bytedance/seedance-2.5-flash/image-to-video",
"input": {
"image_url": "https://example.com/potter-portrait.jpg",
"last_image_url": "https://example.com/potter-portrait.jpg",
"prompt": "The potter cups the spinning clay and slowly draws its wall upward, then lifts her eyes to the camera with a warm smile and settles back into the same pose. Locked-off medium shot, soft window light. Audio: the steady hum of the wheel and the wet squeak of clay, no music.",
"duration_seconds": 4,
"resolution": "480p",
"generate_audio": true
}
}
응답 예시
제출하면 작업 ID가 곧바로 돌아옵니다.
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "queued"}}
GET /api/v1/jobs/recordInfo?taskId=task_abc123을 폴링하거나 callBackUrl을 지정하십시오. 완료된 작업에는 MP4가 나열됩니다(작업 API 가이드 참조).
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "succeeded", "output": {"assets": [{"url": "https://example.com/potter.mp4"}]}}}
파라미터
| 파라미터 | 값 | 기본값 |
|---|---|---|
image_url | 시작 프레임 | 필수 |
last_image_url | 종료 프레임, image_url과 함께 전송 | 선택 |
prompt | 움직임, 카메라, 사운드 | 필수 |
duration_seconds | 4~30 | 5 |
resolution | 480p, 720p | 720p |
generate_audio | true, false | true |
watermark | 보이는 모델 워터마크 | false |
return_last_frame | 마지막 프레임을 JPEG로도 반환 | false |
output_format | mp4, mov | mp4 |
이 엔드포인트에는 aspect_ratio 필드가 따로 없습니다. BytePlus 문서에 따르면 모델은 출력 화면비를 시작 프레임과 일치하게 유지합니다.
과금 방식
요청한 초만큼 과금되며 해상도가 단가를 정합니다. 이 페이지의 가격에 두 값이 모두 표시됩니다. 도예가 요청은 4초를 요청했고 파일은 4.064초였으며, 과금은 4초 기준이었습니다. 종료 프레임, 오디오 켬/끔, 워터마크, 마지막 프레임 JPEG, 파일 형식은 가격에 영향을 주지 않습니다. 실패한 생성에는 요금이 부과되지 않습니다.
좋은 결과를 얻는 요령
- 이미 시작 장면처럼 보이는 프레임을 고르십시오. 사진이 피사체, 배경, 빛을 정하므로 샷이 시작될 자리에 피사체를 두십시오.
- 올리기 전에 잘라 두십시오. 저희 세로 원본은 480p에서 562×748로 돌아왔습니다. 세로형은 9:16, 정사각형은 1:1, 가로형은 16:9로 잘라 두십시오.
- 움직임을 프롬프트로 쓰십시오. 도예가 프롬프트는 옷이나 작업실을 묘사하지 않습니다. 동작을 순서대로 적은 뒤 카메라와 빛을 씁니다.
Audio:줄로 마무리하십시오. 예시의 물레 소리와 점토의 젖은 마찰음처럼 사진에서 짐작되는 소리를 나열하십시오. ‘no music’을 쓰면 트랙이 비어 있어 직접 만든 음악을 얹기 좋습니다.last_image_url은 세 가지로 쓸 수 있습니다. 시작 사진을 그대로 반복하면 루프나 포즈 복귀가 되며, 저희 도예가 실행은 원본 포즈로 돌아와 끝났습니다. 구도와 빛이 같은 관련 사진을 보내면 A에서 B로 가는 움직임이 되니 그 경로를 설명하십시오. 아니면 아예 생략합니다.- 두 프레임을 맞추십시오. 피사체 위치, 크롭, 빛을 가깝게 유지하십시오. 저희에게 루프 실행 기록은 한 건뿐이므로, 끊김 없는 반복에 의존하기 전에 이음매를 플레이어에서 확인하십시오.
- 샷을 이어 붙이십시오.
return_last_frame을 켜고 돌아온 JPEG를 다음image_url로 보냅니다.
저희 테스트 결과
2026년 11월 13일에 위의 도예가 요청(4초, 480p, 오디오 켬)은 562×748, 4.064초의 클립으로 돌아왔고, 시작과 끝 프레임이 모두 원본 포즈로 돌아왔습니다. 같은 요청이 한 번은 84초, 다른 한 번은 4.8분이 걸렸으니 몇 분이 걸린다고 보고 폴링이나 callBackUrl을 쓰십시오. 더 길거나 720p인 클립은 더 오래 걸립니다.
제한과 오류
- Flash는 480p와 720p로 렌더하며 1080p, 4K, 영상 연장 엔드포인트가 없습니다.
image_url과prompt는 모두 필수이고,duration_seconds는 4~30의 정수여야 합니다. 이를 어긴 요청은 유효하지 않으니 필드를 고쳐 다시 제출하십시오.- 모델은 자체 저작권·초상 검사를 거치며, 이 검사가 저희 텍스트→영상 요청 하나를 막았습니다. 실패한 작업에는 요금이 부과되지 않으니, 같은 요청을 그대로 다시 보내지 말고 사진이나 표현을 바꾸십시오.
- 소유했거나 이 용도로 사용 허가를 받은 사진만 보내십시오. 실존 인물의 사진을 허락 없이 움직이거나 그 결과를 실제 영상처럼 내세우지 마십시오.
다른 엔드포인트를 고를 때
- Seedance 2.5 이미지→영상: 1080p나 4K, 초안 모드, 클립 연장이 필요할 때.
- Seedance 2.0 Fast: 480p와 720p의 이전 세대.
- Flash 레퍼런스→영상: 인물이나 제품이 장면을 여는 것이 아니라 새 장면에 등장해야 할 때.
- Flash 텍스트→영상: 사진이 없을 때. 고칠 클립이 있으면 Flash 영상 편집.
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/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"output_format": "mp4",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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 레퍼런스에서 확인하세요.










