소개
draft_task_id에는 draft를 true로 두고 성공한 본인의 Seedance 2.5 텍스트-비디오 또는 이미지-비디오 작업을 지정합니다. 완성본은 초안의 길이, 화면비, 오디오 설정을 유지하고 화질만 1080p로 올립니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 엔드포인트 | text-to-video · image-to-video · reference-to-video · video-extend · video-edit |
| 클립 길이 | 4–30초 · 기본값: 5초 |
| 해상도 | 480p, 720p(기본), 1080p, 4k(텍스트·이미지 모드) |
| 화면비 | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive(기본, image-to-video는 adaptive만) |
| 오디오 |
|
| 레퍼런스 | 이미지 30장, 영상 10개, 오디오 10개까지 — reference-to-video에만 |
핵심 기능 및 하이라이트
소리가 영상과 같은 파일에 담겨 돌아옵니다
Seedance 2.5는 최대 30초의 장면을 구성하며 텍스트, 시작 이미지, 여러 참조 자료 중 제작의 출발점을 선택하도록 지원합니다.
레퍼런스 서른 장, 컷 하나
Seedance 2.5 참조 모드에서는 이미지가 외형을, 영상이 움직임을, 오디오가 리듬을 안내합니다. 각 자료의 역할을 프롬프트에서 구분합니다.
첫 프레임과 마지막 프레임, 그 사이의 30초
Seedance 2.5는 기본 설정인 generate_audio=true에서 영상과 소리를 함께 생성합니다. 대사, 동작음, 환경음을 나누어 적으면 시간 관계를 명확히 전달할 수 있습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
draft_task_id | 예 | Seedance 2.5 초안의 작업 ID를 붙여 넣습니다. draft를 true로 두고 완료된 본인의 텍스트-비디오 또는 이미지-비디오 작업이어야 하며, 완료된 지 6일이 지나지 않아야 합니다. 1자 이상 · 64자 이하 |
resolution | 아니요 | 현재 이 완성 단계에서 고를 수 있는 크기는 1080p뿐입니다. 완성본은 그 크기에서 초안의 구도를 유지합니다. |
duration_seconds | 아니요 | duration_seconds는 비워 두십시오. 초안에서 그대로 가져옵니다. |
generate_audio | 아니요 | generate_audio를 비워 두면 초안의 오디오 설정을 그대로 씁니다. 완성 단계에서 사운드트랙을 더하거나 뺄 수 없으므로 어긋나는 값은 거부됩니다. |
output_format | 아니요 | Seedance 2.5 생성 파일은 기본값인 mp4 또는 mov를 선택합니다. 해상도 조절이 아니라 편집 환경과의 호환성을 기준으로 고릅니다. |
return_last_frame | 아니요 | return_last_frame을 켜면 Seedance 2.5 영상과 함께 종료 이미지가 반환됩니다. 기본값은 꺼짐이며 후속 이미지 기반 장면의 준비에 활용할 수 있습니다. 기본값: |
watermark | 아니요 | watermark는 Seedance 2.5 결과에 모델의 AI 생성 표시를 요청하며 기본값은 false입니다. 게시할 서비스의 표시 요건을 확인한 뒤 설정합니다. 기본값: |
요금
$0.717 / 초
1080p 완성본은 마무리하는 초안의 초 단위 길이에 따라, 초안의 오디오 설정에 맞는 1080p 요금으로 청구됩니다. 480p 미리보기 요금은 생성 당시에 따로 청구되었습니다.
활용 사례
바와 클럽, 백스테이지 장면
Seedance 2.5는 기본 설정인 generate_audio=true에서 영상과 소리를 함께 생성합니다. 대사, 동작음, 환경음을 나누어 적으면 시간 관계를 명확히 전달할 수 있습니다.
커플 장면까지 담는 무검열 단편
아직 촬영 자료가 없는 장면은 Seedance 2.5 텍스트 모드로 구상합니다. 피사체와 사건 순서, 카메라 이동, 필요한 소리를 구체적으로 작성합니다.
제품 컷에서 시작하는 제품 필름
Seedance 2.5의 이미지 모드에서는 승인된 시작 이미지로 구도를 정하고 이후의 움직임을 지시합니다. 결과에서는 원본 디자인이 움직이는 동안 유지되는지 확인합니다.
같은 사람으로 남는 시리즈 캐릭터
Seedance 2.5 참조 모드에서는 이미지가 외형을, 영상이 움직임을, 오디오가 리듬을 안내합니다. 각 자료의 역할을 프롬프트에서 구분합니다.
프롬프트 가이드 및 실전 팁
Seedance 2.5 API는 어떤 제작에 적합합니까
Seedance 2.5는 최대 30초의 장면을 구성하며 텍스트, 시작 이미지, 여러 참조 자료 중 제작의 출발점을 선택하도록 지원합니다.
Seedance 2.5 프롬프트는 어떻게 작성합니까
Seedance 2.5 장면을 연속된 시간 구간으로 나누고 구간마다 보이는 사건을 정리합니다. 텍스트와 참조 모드에서는 필수이며 이미지 모드에서는 생략할 수 있습니다.
Seedance 2.5 완성 영상은 어떻게 받습니까
Seedance 2.5 요청에 Idempotency-Key를 넣고 반환된 작업 ID로 상태를 조회합니다. 연결이 끊겨도 새 생성을 요청하기 전에 기존 작업부터 확인합니다.
Seedance 2.5 초안 모드란 무엇입니까
초안 모드는 Seedance 2.5 장면 하나를 유료 두 단계로 나눕니다. 먼저 480p 미리보기로 구도와 움직임을 판단하고, 만족하면 바로 그 미리보기를 1080p로 렌더링합니다.
초안은 언제까지 완성해야 합니까
미리보기가 끝난 뒤 6일 안에 완성하십시오. 그 이후에는 저장된 초안 참조가 만료되어 청구 전에 요청이 거부되므로 새 초안을 만들어야 합니다.
어떤 작업을 1080p로 완성할 수 있습니까
draft를 true로 두고 성공한 본인의 텍스트-비디오 또는 이미지-비디오 작업만 가능합니다. 일반 렌더링, 실패한 초안, 다른 계정의 작업, 레퍼런스-비디오 작업은 제출 시 거부됩니다.
1080p 완성본은 미리보기와 일치합니까
자체 테스트에서 1080p 완성본은 미리보기의 구도, 피사체 위치, 카메라 경로를 프레임 단위로 유지하면서 질감만 더 세밀해졌습니다. 다만 새 렌더링이므로 물결 같은 작은 부분은 조금 달라질 수 있습니다.
초안 완성은 어떻게 청구됩니까
1080p 완성본은 마무리하는 초안의 초 단위 길이에 따라, 초안의 오디오 설정에 맞는 1080p 요금으로 청구됩니다. 480p 미리보기 요금은 생성 당시에 따로 청구되었습니다.
Seedance 2.5에 인물, 제품, 음원을 전달하기 전에 이용 허락과 성인 참여자의 동의를 확인합니다. 비동의 자료나 실제 인물로 오인시키는 사칭은 허용되지 않습니다.
Seedance 2.5에 인물, 제품, 음원을 전달하기 전에 이용 허락과 성인 참여자의 동의를 확인합니다. 비동의 자료나 실제 인물로 오인시키는 사칭은 허용되지 않습니다.
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/upscale",
"input": {
"resolution": "1080p",
"draft_task_id": "example",
"output_format": "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 레퍼런스에서 확인하세요.










