소개
프롬프트만 보내면 16:9, 사운드 포함의 5초 720p 클립을 받습니다. duration_seconds, resolution, aspect_ratio, generate_audio, watermark, return_last_frame, output_format을 더하면 결과를 조정할 수 있습니다. 업로드할 것은 없습니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 영상 |
| 제작사 | 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 | 예 | 주제, 핵심 동작 하나, 카메라 움직임, 빛, 그리고 들리는 소리를 나열하는 마지막 Audio: 줄을 이 순서로 쓰십시오. 테스트한 프롬프트가 이 순서를 따랐고 클립도 그대로 나왔습니다. 1자 이상 · 20000자 이하 |
aspect_ratio | 아니요 | 16:9(기본), 9:16, 4:3, 3:4, 1:1, 21:9 또는 adaptive이며, adaptive는 화면 형태를 모델에 맡깁니다. 피드나 플레이어가 특정 비율을 요구하면 고정 비율을 쓰십시오. |
resolution | 아니요 | 480p 또는 720p이며 기본값은 720p입니다. 가로형 480p 요청은 854×480으로 돌아왔으니, 480p에서 샷을 확정한 뒤 잘 나온 프롬프트를 720p로 다시 돌리십시오. |
duration_seconds | 아니요 | 4에서 30까지의 정수 초이며 기본값은 5이고 요청한 대로 과금됩니다. 클립을 자르거나 이어 붙일 계획이라면 필요한 길이보다 1초 더 요청하십시오. |
generate_audio | 아니요 | 기본값은 true입니다. 프롬프트에 맞는 음성, 효과음, 환경음이 영상과 함께 만들어지며, 저희 테스트는 AAC 스테레오 트랙을 돌려주었습니다. 기본값: |
output_format | 아니요 | mp4(기본) 또는 mov입니다. BytePlus는 mov를 yuv444p 크로마 샘플링의 H.264 영상과 PCM 오디오로 문서화하고 있어 편집 타임라인에 알맞으며, 저희 테스트 클립은 mp4였습니다. |
return_last_frame | 아니요 | 기본값은 false입니다. true로 하면 마지막 프레임을 JPEG로도 돌려주며(저희 480p 16:9 테스트에서는 854×480), 이미지→영상 엔드포인트에서 샷을 이어 갈 때 그대로 image_url로 쓸 수 있습니다. 기본값: |
watermark | 아니요 | 기본값은 false입니다. ByteDance의 클라우드 플랫폼인 BytePlus는 true로 하면 영상 오른쪽 아래에 AI 생성 표시가 들어간다고 밝히므로, 편집할 파일에는 꺼 두십시오. 기본값: |
요금
요청한 초를 480p 또는 720p 단가로 과금하며, 4초 요청이 4.06초로 돌아와도 4초로 과금됩니다. 오디오, 화면비, 워터마크, 마지막 프레임, 파일 형식은 가격에 영향을 주지 않고, 실패한 요청에는 요금이 부과되지 않습니다.
| 사양 | 요금 |
|---|---|
| $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 텍스트→영상은 프롬프트만으로 생성하는 ByteDance의 Seedance 2.5 속도 티어입니다. 텍스트를 보내면 480p 또는 720p의 4~30초 클립이 돌아오며, 음성, 효과음, 환경음이 같은 패스에서 함께 만들어집니다. ByteDance의 클라우드 플랫폼인 BytePlus는 Flash가 플래그십에 근접한 결과를 거의 2배의 생성 속도로 낸다고 설명하고, 1080p와 4K는 지원하지 않는 것으로 표시합니다.
요청 예시
공개 이름 bytedance/seedance-2.5-flash/text-to-video로 작업을 만듭니다. Authorization: Bearer YOUR_SPICY_API_KEY와 Content-Type: application/json 헤더를 붙여 POST https://api.spicyapi.ai/api/v1/jobs/createTask를 호출하십시오. 폴링과 콜백은 작업 API 가이드에서 다룹니다.
{
"model": "bytedance/seedance-2.5-flash/text-to-video",
"input": {
"prompt": "A young woman in a yellow raincoat sprints across a rain-soaked city crosswalk at night, neon signs reflected in the wet asphalt. She ducks under a shop awning, pushes back her hood and laughs, shaking water from her hair. Handheld tracking shot at street level. Audio: heavy rain on pavement, a passing car hissing through puddles, her breathless laugh.",
"duration_seconds": 4,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": true,
"return_last_frame": true
}
}
응답 예시
제출하면 queued 상태의 작업이 돌아옵니다. succeeded가 될 때까지 GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID를 폴링하거나 callBackUrl을 지정하십시오.
{"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/clip.mp4"}]}}}
return_last_frame을 켜면 완료된 작업이 마지막 프레임의 JPEG도 함께 돌려줍니다.
파라미터
| 파라미터 | 값 | 기본값 |
|---|---|---|
prompt | 텍스트 브리프 | 필수 |
duration_seconds | 4~30 | 5 |
resolution | 480p, 720p | 720p |
aspect_ratio | 16:9, 9:16, 4:3, 3:4, 1:1, 21:9, adaptive | 16:9 |
generate_audio | true, false | true |
watermark | true, false | false |
return_last_frame | true, false | false |
output_format | mp4, mov | mp4 |
과금 방식
텍스트→영상은 요청한 초를 선택한 해상도의 단가로 과금하며, 이 페이지에는 1초 가격이 표시됩니다. 4초 요청이 4.064초로 돌아왔고 4초로 과금되었습니다. 오디오, 화면비, 워터마크, 마지막 프레임, 형식은 가격에 영향을 주지 않으며, 실패한 생성에는 요금이 부과되지 않습니다.
텍스트만으로 샷 쓰기
프롬프트 순서. 주제와 그 핵심 동작 하나로 시작하고 카메라, 빛, 소리를 이어 쓰십시오. BytePlus는 주제, 동작, 장면, 시각 스타일, 카메라, 사운드를 나열하면서 필요 없는 부분은 빼도 된다고 하고, Dreamina는 Flash 프롬프트를 간결하게 쓰고 분명한 동작 하나에 집중하라고 합니다. 테스트한 프롬프트는 한 거리에 머뭅니다. 노란 레인코트, 비를 피하는 달리기, 핸드헬드 트래킹 샷, 젖은 아스팔트에 비친 네온입니다.
사운드. Audio: 줄을 마지막에 두고 소리의 출처를 쉬운 말로 나열하십시오. 대사는 따옴표 안에 넣고 앞에 언어와 어조를 밝히는데, 이는 BytePlus가 중국어가 아닌 대사에 제시하는 규칙입니다. BytePlus는 음악, 효과음, 대사에 대괄호를 쓰는 방식도 문서화하지만 저희는 일반 줄만 테스트했습니다.
화면 형태. 가로형 플레이어에는 16:9, 세로형 피드에는 9:16, 그리드에는 1:1, 4:3, 3:4, 넓게 잘라 쓸 때는 21:9를 쓰십시오. adaptive는 모델이 정하며 초기 탐색에 알맞습니다. 템플릿이 정해진 비율을 기대하면 고정 비율을 지정하십시오.
길이. 저희 4초 테스트에는 달린다, 비를 피한다, 웃는다의 세 비트가 담겼습니다. 815초라면 하나의 카메라 아이디어 아래 두세 개의 비트를 계획하십시오. 1630초에는 시간 범위를 붙인 줄(0-8 s: ..., 8-20 s: ...)을 쓰십시오. ByteDance Seed는 프롬프트로 특정 시간대의 서사, 카메라, 리듬을 이끌 수 있다고 밝힙니다. 저희는 4초 요청만 돌렸으므로, 더 긴 구성은 720p로 올리기 전에 480p에서 시험하십시오.
이어 붙이기. return_last_frame을 true로 두고, 돌아온 JPEG를 bytedance/seedance-2.5-flash/image-to-video의 image_url로 넘기면서 다음 비트의 프롬프트를 쓰십시오. 시작 이미지가 형태를 정하므로 16:9 프레임은 16:9로 이어집니다. 클립마다 자체 사운드트랙이 생성되니 Audio: 표현을 재사용하십시오. 많은 생성기가 클립 끝에서 움직임을 늦추므로, 필요한 길이보다 1초 더 요청한 뒤 잘라 쓰십시오.
파일 설정. 재생에는 mp4, 편집 타임라인에는 mov를 쓰십시오. BytePlus는 mov를 yuv444p 크로마 샘플링의 H.264 영상과 PCM 오디오로 문서화합니다. 플랫폼이 표시를 요구하지 않는 한 watermark는 꺼 두십시오. BytePlus에 따르면 켜면 오른쪽 아래에 AI 생성 표시가 붙습니다.
저희 테스트 결과
| 실행(2026년 11월 13일) | 결과 |
|---|---|
| 4초, 480p, 16:9, 오디오 켬 | 854×480, 24fps, 4.064초, AAC 스테레오. 쓴 그대로 달려서 건너고, 차양 아래로 몸을 피하고, 웃었습니다. 한 번은 2.6분, 다른 한 번은 약 11분 만에 끝났습니다. |
같은 요청에 return_last_frame 추가 | MP4와 마지막 프레임의 854×480 JPEG. |
Flash 네 엔드포인트 전체에서 4초 480p 실행은 84초에서 약 11분이 걸렸으므로 속도 향상은 확인하지 못했습니다. 더 길거나 720p인 클립은 더 오래 걸립니다. 여러 샷을 이은 전체 체인과 mov는 테스트하지 않았습니다. 같은 요청을 중복 제출하면 렌더가 한 번 더 시작되니 첫 작업을 기다리십시오.
제한과 오류
- 4~30초,
480p나720p, 나열된 화면비를 벗어난 값은 제출 단계에서 거부됩니다. - 모델은 자체 저작권·초상 검사를 거치며, 저희 텍스트 요청 하나가 여기서 멈췄습니다. 실존 인물이나 보호받는 캐릭터 대신 만들어 낸 인물로 다시 쓰십시오. 실패한 작업에는 오류 메시지가 붙고 요금이 부과되지 않습니다.
- ByteDance Seed는 복잡한 동작 물리와 여러 피사체가 상호작용하는 장면에 아직 개선 여지가 있다고 밝히므로, 한 샷에는 한두 명의 피사체만 담으십시오.
- Flash에는 1080p, 4K, 영상 연장 엔드포인트가 없습니다. 완료된 파일은 14일간 보관됩니다.
다른 엔드포인트나 모델을 고를 때
- Seedance 2.5: 720p를 넘는 납품, 4K, 클립 연장, 초안 후 업스케일.
- Seedance 2.0 Fast: 480p와 720p의 이전 세대 고속 티어로, Flash에 없는 연장 엔드포인트가 있습니다.
- 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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"output_format": "mp4",
"duration_seconds": 5
}
}'
# 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 레퍼런스에서 확인하세요.










