소개
Seedance 2.0 Mini 텍스트→영상은 피사체, 세트, 카메라, 조명까지 화면 전체를 프롬프트로 구성하고 사운드트랙도 같은 패스에서 만듭니다. 아무도 찍으러 가지 않을 컷을 채우는 엔드포인트입니다.
Seedance 2.0 Mini는 ByteDance Seedance 2.0 라인에서 가장 작은 등급입니다. Seedance 2.0 Fast와 같은 엔드포인트를 공개하며, 480p 또는 720p의 4~15초 클립을 같은 패스에서 만든 오디오와 함께 돌려줍니다.
시작 자료로 Seedance 2.0 Mini 모드 고르기
| 시작 자료 | 모드 |
|---|---|
| 대본이나 장면 설명 | Seedance 2.0 Mini 텍스트→영상 |
| 확정된 시작 이미지 | Seedance 2.0 Mini 이미지→영상 |
| 외형, 움직임, 오디오를 나눈 레퍼런스 | Seedance 2.0 Mini 레퍼런스→영상 |
핵심 기능 및 하이라이트
Seedance 2.0 Fast와 같은 규격
Mini의 엔드포인트와 필드는 Seedance 2.0 Fast와 같습니다. 적응형 화면비와 고정 비율 여섯 가지, 4~15초(-1이면 모델이 길이를 정함), 네이티브 오디오, seed를 갖추고 해상도만 720p까지입니다. Mini용으로 만든 파이프라인은 요청이 아니라 모델 ID만 바꿔 Fast로 옮길 수 있습니다.
대량 생성용
더 큰 Seedance 2.0 모델의 추가 품질보다 처리량이 중요할 때 고르는 등급이 Mini입니다. 모든 엔드포인트가 비동기이므로 요청마다 Idempotency-Key를 보내고, 태스크 ID를 저장한 뒤 폴링이나 콜백으로 결과를 받으십시오. 키는 24시간 유효하므로 연결이 끊긴 뒤 다시 시도해도 원래 태스크가 돌아옵니다.
영상 연장으로 긴 시퀀스 만들기
15초를 넘기려면 완성된 클립을 video-extend 엔드포인트에 보내십시오. 클립의 마지막 프레임이 Seedance 2.0 Mini 새 샷의 시작 프레임이 되고, 두 부분이 합쳐진 파일 하나가 돌아옵니다. 각 단계는 더한 초만큼만 과금되며, 합쳐진 결과는 다시 연장할 수 있습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 화면에 나오는 것의 유일한 출처입니다. 피사체, 동작, 카메라, 빛, 소리 순서로 한 문장에 하나씩 놓으세요. 1자 이상 |
aspect_ratio | 아니요 | 출력 구도입니다. 기본은 adaptive이며, 21:9부터 9:16까지 여섯 가지 고정 비율 중에서 고를 수도 있습니다. |
resolution | 아니요 | 출력 해상도입니다. 480p와 기본인 720p 중에서 고릅니다. |
duration_seconds | 아니요 | 완성 클립의 길이를 정수 초로 지정합니다. 4~15초, 기본 5초이며 그대로 과금 수량이 됩니다. |
generate_audio | 아니요 | 자체 사운드트랙을 화면과 싱크 맞춰 만들지 여부입니다. 기본으로 켜져 있으며, 이 버전에서는 꺼도 요금이 내려가지 않습니다. 기본값: |
enable_web_search | 아니요 | 기본값은 꺼짐입니다. 켜면 모델이 렌더링 전에 프롬프트와 관련된 정보를 웹에서 검색할 수 있습니다. 기본값: |
seed | 아니요 | 정수 seed입니다. 빼면 실행마다 알아서 뽑습니다. |
return_last_frame | 아니요 | 영상과 함께 클립의 마지막 프레임을 별도 이미지로 돌려줍니다. 다음 첫 프레임으로 image-to-video에 넘기면 정지 화면을 직접 뽑지 않고도 샷을 이어 붙일 수 있습니다. 기본값: |
bitrate_mode | 아니요 | 전달되는 파일의 비트레이트입니다. |
watermark | 아니요 | 모델 자체의 ‘AI generated’ 표시 워터마크를 영상에 넣습니다. 기본값은 꺼짐입니다. 기본값: |
요금
| 사양 | 요금 |
|---|---|
| $0.0246078 / 초 |
| $0.05292 / 초 |
활용 사례
일상 B롤을 대량으로
창으로 드는 아침 햇살, 얼굴까지 끌어올린 이불, 햇빛 줄기 속 먼지처럼 카탈로그나 앱에 수백 개씩 필요하지만 누구도 촬영 일정을 잡고 싶어 하지 않는 평범한 샷입니다. 아래 공개 예시가 바로 그런 컷으로, 프롬프트만으로 만들었습니다.
브리프 하나를 모든 비율로
프롬프트를 고정하고 같은 배치에서 16:9, 9:16, 1:1로 나누어 보내십시오. 엔드포인트가 비동기라서 같은 아이디어의 세 가지 비율은 계획할 작업 세 건이 아니라 받아 올 태스크 ID 세 개일 뿐입니다.
같은 요청 형식으로 다양한 룩
같은 필드로 실사와 양식화된 애니메이션을 모두 다룹니다. 이 엔드포인트의 예시에는 망원 렌즈로 담은 비 오는 밤거리와 눈 내리는 노천 온천을 그린 셀 셰이딩 애니메이션 장면이 있습니다. 룩은 프롬프트에서 정하며 추가 필드는 필요 없습니다.
프롬프트 가이드 및 실전 팁
피사체, 동작, 카메라, 조명, 소리 순으로
한 문장에 한 가지씩, 이 순서로 쓰십시오. duration_seconds를 늘려 시간이 생기면 두 번째 동작을 더하지 말고 이미 쓴 동작을 끝까지 보여 주는 데 쓰십시오.
Seedance가 거절하는 표현은 바꿔 쓰기
저희는 표현을 심사하지 않지만 Seedance 자체 레이어가 일부를 생성 전에 거절하며, 키스는 거의 항상 거절됩니다. 같은 장면을 귓가의 속삭임이나 이마를 맞대는 모습으로 쓰면 통과하고, 이미지→영상에서 시작 프레임을 쓰면 문자 그대로의 장면도 통과합니다.
포함된 예시 응용하기
공개된 예시는 aspect_ratio 16:9, duration_seconds 5, generate_audio true, resolution 720p를 씁니다.
Morning in a sunlit studio apartment. An adult woman in an oversized grey t-shirt stretches her arms overhead beside the window, the hem lifting slightly, then drops onto the unmade bed and pulls the duvet over her face laughing. Warm dust in the light shaft, handheld, soft film grain, quiet room tone and distant traffic.
핸드헬드 느낌과 조용한 실내음을 담은 평범한 컷이며, 이 등급이 있는 이유가 바로 이것입니다. 방과 제스처를 바꾸고 동작 하나라는 구조는 유지하십시오.
나중에 음악을 입힐 때만 오디오 끄기
이 등급에서는 generate_audio를 꺼도 요금이 바뀌지 않습니다. 앰비언스가 장면을 살린다면 켜 두고, 무음 루프나 후반 작업에서 음악을 넣을 때만 끄십시오.
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.0-mini/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"generate_audio": true,
"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 레퍼런스에서 확인하세요.
