소개
video_url과 prompt를 보내십시오. reference_image_urls, reference_audio_urls, resolution, generate_audio는 선택입니다. 결과는 원본 클립을 따르므로 요청에 길이 필드는 없습니다. generate_audio를 끄면 클립의 원래 소리가 출력에 남습니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 제작사 | 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, 레퍼런스 오디오는 @Audio 1로, 업로드 순서대로 숫자 앞에 공백을 두고 부르십시오. 1자 이상 · 20000자 이하 |
video_url | 예 | 편집할 MP4 링크이며 길이는 4~30초여야 합니다. 이 범위를 벗어나면 과금 전에 거부됩니다. 1자 이상 |
reference_image_urls | 아니요 | 목표로 하는 모습(의상, 소품, 색상 보드 등)을 보여 주는 선택 이미지 최대 10장입니다. 어느 @Image가 어떤 요소에 해당하는지 프롬프트에 적으십시오. 1개 이상 · 10개 이하 |
reference_audio_urls | 아니요 | 모델이 만드는 사운드트랙을 목소리나 분위기 쪽으로 이끄는 선택 오디오 파일 최대 5개, 합계 30초입니다. generate_audio를 true로 두고 함께 쓰십시오. 1개 이상 · 5개 이하 |
resolution | 아니요 | 480p 또는 720p이며 기본값은 720p입니다. 표현은 480p에서 확정한 뒤 승인된 프롬프트를 720p로 다시 돌리십시오. |
generate_audio | 아니요 | true(기본)는 편집된 영상에 맞는 새 사운드트랙을 만들고, false는 클립의 원래 소리를 유지합니다. 저희 오디오를 끈 실행은 원본과 일치하는 44.1kHz 트랙을 돌려주었고, 오디오를 켠 실행은 4.0초 원본보다 0.288초 짧게 돌아왔습니다. 기본값: |
요금
올린 원본 클립의 초 수(4~30초, 올림)를 480p 또는 720p 단가로 과금하며, 결과가 몇 초로 돌아오든 같습니다. 레퍼런스 이미지, 레퍼런스 오디오, 오디오 스위치는 요금에 영향을 주지 않고, 실패한 작업에는 요금이 부과되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.18 / 초 |
| $0.36 / 초 |
활용 사례
최종 렌더 전에 샷 계획 시험하기
비 내리는 밤의 횡단보도 같은 장면을 ‘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 영상 편집은 ByteDance 속도 티어 영상 모델의 지시 기반 편집 작업입니다. 4~30초 클립을 올리고 무엇이 달라 보여야 하는지 설명하면 480p 또는 720p로 다시 렌더해 돌려줍니다. 날씨, 시간대, 의상, 소품이 흔한 대상이며, 인물과 그 움직임, 카메라 경로는 모델이 유지하도록 요청하는 부분입니다.
ByteDance의 클라우드 플랫폼인 BytePlus는 Flash를 ‘플래그십 Seedance 2.5에 근접한 결과를 거의 2배의 생성 속도로’ 내는 모델로 소개합니다. 이곳에서 오디오 스위치는 두 가지 역할을 합니다. generate_audio: false는 클립의 원래 사운드트랙을 유지하고, true는 첨부한 음성 파일을 따를 수 있는 새 사운드트랙을 만듭니다.
요청 예시
저희 테스트의 눈 내리는 장면 편집입니다. 작업 API 가이드에 따라 Authorization: Bearer YOUR_SPICY_API_KEY와 함께 POST https://api.spicyapi.ai/api/v1/jobs/createTask로 보내십시오.
{
"model": "bytedance/seedance-2.5-flash/video-edit",
"input": {
"prompt": "Turn the sunny afternoon into a snowy winter evening: fresh snow on the rooftops, balconies and cobblestones, snowflakes drifting through the air and warm light in the windows. Keep both riders, their bikes, their clothes, their movement, the tram and the camera move exactly as in the source video.",
"video_url": "https://example.com/tram-street.mp4",
"resolution": "480p",
"generate_audio": false
}
}
응답 예시
제출하면 작업 ID가 돌아옵니다. GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID를 폴링하거나 callBackUrl을 지정하십시오. 완료된 작업에는 편집된 MP4가 나열됩니다.
{ "code": 200, "msg": "success", "data": { "taskId": "YOUR_TASK_ID", "state": "queued" } }
{ "code": 200, "msg": "success", "data": { "taskId": "YOUR_TASK_ID", "state": "succeeded",
"output": { "assets": [ { "url": "https://example.com/edited-tram-street.mp4" } ] } } }
파라미터 표
prompt와 video_url은 필수입니다.
| 파라미터 | 값 / 기본값 | 역할 |
|---|---|---|
prompt | 필수, 최대 20,000자 | 바꿀 내용, 그다음 그대로 둘 것 |
video_url | 필수, MP4, 4~30초 | 편집할 클립 |
reference_image_urls | 최대 10장 | 목표 모습, @Image 1, @Image 2로 부름 |
reference_audio_urls | 최대 5개, 합계 30초 | 목소리나 분위기, @Audio 1로 부름 |
resolution | 480p 또는 720p, 기본 720p | 출력 크기 |
generate_audio | 기본 true | 새 소리(true) 또는 원본 소리(false) |
과금 방식
요금은 받는 클립이 아니라 올린 클립을 따릅니다. 원본의 초 수(4~30초, 올림)가 선택한 해상도의 단가로 계산되며, 이 페이지에 표시됩니다. 4.0초 원본이 3.712초로 돌아와도 4초로 과금됩니다. 레퍼런스와 오디오 스위치는 아무것도 바꾸지 않으며, 실패한 작업에는 요금이 부과되지 않습니다.
좋은 결과를 얻는 요령
- 바꿀 내용을 쓰고, 그다음 유지 목록을 쓰십시오. 변경 한 문장에 남겨야 할 모든 것을 가리키는 절을 붙이는 방식이 저희 실행에서 잘 통했습니다. ByteDance의 크리에이티브 앱 Dreamina는 인물, 의상, 카메라 경로, 타이밍을 먼저 고정하라고 제안하며, 두 부분만 다 쓰면 순서는 어느 쪽이든 괜찮습니다.
- 눈에 보이는 결과를 이름으로 적으십시오. 눈 내리는 프롬프트는 눈이 화면에서 하는 일을 나열합니다. 눈 덮인 지붕, 공중의 눈송이, 창가의 따뜻한 빛입니다. ‘겨울로 바꿔 줘’ 같은 한 줄에는 바뀔 표면이 하나도 적혀 있지 않습니다.
- 한 번에 한 가지만 바꾸십시오. 날씨와 빛은 하나의 장면 변화입니다. 새 재킷은 두 번째 패스에서 더해야 어느 절이 무엇을 했는지 볼 수 있습니다.
- 소리 설정을 미리 정하십시오. 오디오를 끄면 지키고 싶은 대사나 음악이 보호됩니다. 새 소리가 필요한 영상에는 오디오를 켜고, 음성 파일을 @Audio 1로 붙인 뒤
Audio:줄을 더하십시오. - 프레임 단위로 확인하십시오. ByteDance의 Seedance 2.5 발표는 복잡한 움직임과 여러 피사체가 상호작용하는 장면이 아직 개선 중이라고 밝히므로, 붐비는 순간은 한 프레임씩 넘겨 보십시오. 레퍼런스 이미지(‘@Image 1의 재킷’)는 저희 실행에 쓰지 않았으니, 4초로 자른 영상에서 먼저 시험하십시오.
저희 테스트 결과
2026년 11월 13일에 자전거를 탄 두 사람과 트램이 있는 화창한 거리의 4.0초 클립을 480p에서 두 번 편집했습니다.
| 실행 | 설정 | 결과 | 제출부터 완료까지 |
|---|---|---|---|
| 눈 내림, 소리 유지 | 눈 내리는 저녁 프롬프트, 오디오 끔 | 854×480, 4.000초. 자전거 탄 사람들, 트램, 카메라가 원본과 프레임 단위로 일치하고 날씨와 빛이 바뀌었으며 원본 사운드트랙(44.1kHz) 유지 | 3.7분 |
| 눈 내림, 새 음성 | 같은 프롬프트, 음성 파일을 @Audio 1로, 오디오 켬 | 3.712초. 편집 품질은 같고 새 사운드트랙 | 7.8분 |
그날 Flash 네 엔드포인트 전체에서 4초 480p 클립은 84초에서 약 11분이 걸렸습니다. 편집 두 번으로는 BytePlus의 ‘거의 2배’라는 설명을 확인할 수 없으니, 몇 분이 걸린다고 보고 계획하십시오. 더 긴 클립과 720p는 더 오래 걸립니다.
제한과 오류
- 원본 길이. 4초 미만이거나 30초를 넘는 클립은 제출 단계에서 거부되며 요금은 부과되지 않습니다. 잘라 쓰거나, 긴 클립은 나눠서 각 부분에 같은 유지 목록을 재사용하십시오.
- 결과 길이. 길이 필드가 없습니다. 오디오를 켜면 결과가 조금 짧아질 수 있습니다(여기서는 4.0초에서 3.712초). 정확한 길이가 필요하면 오디오를 끄고 편집하고 소리는 직접 쓰는 편집기에서 얹으십시오.
- 해상도. 480p와 720p입니다. ByteDance는 Flash에서 1080p와 4K를 지원하지 않는 것으로 표시합니다.
- 모델 검사. 모델은 자체 저작권·초상 검사를 적용하며 요청을 거절하거나 수위를 낮출 수 있습니다. 막힌 작업은 요금 없이 실패합니다. 문구를 고치고 실존 인물이나 브랜드를 빼서 다시 제출하십시오.
- 권리와 보관. 사용할 권리가 있는 영상과 음성만 편집하십시오. 완료된 파일은 14일간 보관됩니다.
다른 엔드포인트를 고를 때
- Seedance 2.5 영상 편집: 720p를 넘는 최종 납품에 쓰며, 플래그십은 1080p까지 편집합니다. 여기 설정을 그대로 가져가기 전에 그쪽의 오디오 안내를 읽으십시오.
- Seedance 2.5 Flash 레퍼런스→영상: 클립을 다시 쓰는 대신 클립의 카메라 움직임(@Video 1)을 둘러싼 새 장면을 만들 때.
- Seedance 2.5 영상 연장: 샷이 마지막 프레임을 넘어 이어져야 할 때.
- Seedance 2.0 Fast: 연장이나 텍스트, 이미지, 레퍼런스 작업을 위한 480p와 720p의 이전 세대 고속 티어.
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-edit",
"input": {
"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 레퍼런스에서 확인하세요.










