소개
Seedance 1.5 Pro 이미지→영상은 직접 준비한 그림에서 클립을 시작해 최대 12초까지 움직입니다. camera_fixed를 켜면 준비한 구도가 그대로 유지되므로, 합성에 쓸 수 있는 플레이트를 만드는 엔드포인트입니다.
ByteDance Seedance 1.5 Pro는 텍스트→영상과 이미지→영상 두 엔드포인트를 공개합니다. 둘 다 480p, 720p, 1080p의 4~12초 클립을 네이티브 오디오와 함께 돌려주며 camera_fixed 스위치를 갖추고 있습니다.
시작 자료로 Seedance 1.5 Pro 모드 고르기
| 시작 자료 | 모드 |
|---|---|
| 확정된 시작 이미지 | Seedance 1.5 Pro 이미지→영상 |
| 대본이나 장면 설명 | Seedance 1.5 Pro 텍스트→영상 |
핵심 기능 및 하이라이트
camera_fixed로 화면 고정
기본값인 false에서는 모델이 드리프트, 푸시인, 느린 궤도 이동 같은 카메라 움직임을 스스로 만듭니다. true로 두면 카메라가 멈추고 피사체만 화면 안에서 계속 움직입니다. 고정된 화면은 트래킹, 키잉, 합성, 루프에 쓸 수 있으며 Seedance 2.0과 2.5에는 이 스위치가 없습니다.
같은 패스에서 만드는 소리
generate_audio는 기본값이 true이며 앰비언스, 움직임 효과음, 목소리를 프레임에 맞춰 생성합니다. 요청이 더 높은 요금 구간으로 올라가므로 제품 루프나 나중에 소리를 입힐 소재에서는 끄십시오.
분명한 상한
클립은 4~12초, 해상도는 480p, 720p, 1080p입니다. 화면비는 여섯 가지 고정값이며 기본은 16:9이고 적응형 옵션은 없습니다. 레퍼런스 엔드포인트는 없습니다. seed는 480p와 720p에서 쓸 수 있습니다. 4K, 더 긴 테이크, 여러 이미지를 쓰는 캐스팅이 필요하면 Seedance 2.0이나 2.5를 쓰고, 1.5 Pro에만 남은 장점은 카메라 고정입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수이고, 이미 보이는 걸 다시 말하는 대신 프레임 다음에 무슨 일이 일어나는지 적어야 합니다. 동작과 시간의 흐름, 소리가 그 대상입니다. 3자 이상 |
image_url | 예 | 첫 프레임의 공개된, 바로 내려받을 수 있는 링크이고 필수입니다. 구도와 피사체의 생김새, 색보정, 클립의 품질 상한을 고정합니다. |
last_image_url | 아니요 | 선택 사항인 마지막 프레임입니다. |
aspect_ratio | 아니요 | 출력 구도이고 고정값 여섯 가지에 기본은 16:9입니다. 이 세대에는 adaptive가 없어서, 원본과 어긋나면 요청한 비율로 다시 잡히고 피사체가 여백을 잃을 수 있습니다. |
resolution | 아니요 | 출력 해상도입니다. 기본은 720p이고 위로 1080p까지이며, 여기선 그보다 높은 건 제공하지 않습니다. |
duration_seconds | 아니요 | 정수 초로 4에서 12까지, 기본은 5이고 과금 대상입니다. 컷이 길수록 원본 프레임에서 더 멀리 흔들리니, 늘리기 전에 4~5초에서 움직임을 확인하세요. |
generate_audio | 아니요 | 자체 사운드트랙을 화면과 싱크 맞춰 만들지 여부입니다. 기본으로 켜져 있고 더 높은 요율 구간으로 매겨집니다. 기본값: |
camera_fixed | 아니요 | 카메라를 잠그고 기본값은 false입니다. true로 두면 프레임이 멈춘 채 피사체만 그 안에서 움직입니다. 기본값: |
seed | 아니요 | 무작위 출발점을 정하는 0에서 2147483647까지의 정수입니다. 빼면 실행마다 각자 값을 뽑습니다. |
요금
| 해상도 | 오디오 생성: 아니요 | 오디오 생성: 예 |
|---|---|---|
| $0.0112 / 초 | $0.0223 / 초 |
| $0.0227 / 초 | $0.0454 / 초 |
| $0.0491 / 초 | $0.0982 / 초 |
활용 사례
합성용 플레이트
이미 확정한 스틸을 보내고 camera_fixed를 켜면 피사체만 움직이고 구도는 클립 끝까지 유지됩니다. 결과물은 삼각대로 찍은 영상처럼 다룰 수 있어 키잉용 깨끗한 배경, 타이틀을 트래킹할 안정된 면, 실제 시퀀스에 편집해 넣을 플레이트가 됩니다.
제품 턴테이블과 루프
고정된 화면에서 물체가 도는 것이 대표적인 사례입니다. 흔들림이 없고 수평선이 반듯하게 유지되며 마지막 프레임이 첫 프레임과 충분히 가까워 루프로 쓸 수 있습니다. 제품 루프에는 주변 소리가 거의 필요 없으므로 generate_audio를 끄십시오.
느리게 움직이는 주변 환경
공개된 예시는 스틸 한 장 위에 내리는 눈, 피어오르는 김, 물을 겹치고 아주 느린 푸시인을 써서 카메라 속도에 묻히지 않게 했습니다. 날씨, 연기, 물은 멈춘 구도에서 가장 돋보이는 움직임입니다.
프롬프트 가이드 및 실전 팁
필수 필드 두 개 모두 보내기
여기서는 prompt와 image_url이 모두 필수이며 프롬프트는 3자 이상이어야 합니다. 이미지는 바로 내려받을 수 있는 공개 URL의 JPEG, PNG, WebP 파일이어야 하고 10MB 미만이어야 합니다. 스틸 속 글자, 워터마크, 로고는 영상에도 남으므로 먼저 지우십시오.
화면비를 이미지에 맞추기
적응형 옵션이 없고 aspect_ratio의 기본값은 16:9입니다. 요청한 비율이 원본과 다르면 화면이 다시 잘리면서 피사체의 여백이 사라질 수 있으니 스틸에 맞는 비율을 고르십시오.
포함된 예시 응용하기
공개된 예시는 aspect_ratio 16:9, duration_seconds 5, resolution 720p를 쓰며 오디오는 기본값 그대로입니다.
Snow keeps falling through the lantern light and steam pours off the water. She sets the folded towel robe down on the rock and sinks slowly into the spring up to her collarbone, tipping her head back and exhaling a long plume of breath into the cold air. Steam swells across the frame and snow settles on her wet hair. Very slow push-in, warm lantern gold against deep blue snow.
등롱과 장소는 이미지가 제공하고, 프롬프트는 인물을 온천에 담그고 숨을 내쉬게 할 뿐입니다. 직접 준비한 스틸로 바꿀 때도 이 분담을 유지하십시오.
고정된 화면 안에서 움직이기
camera_fixed가 true라면 화면 안에서 일어나는 움직임만 쓰십시오. 카메라 지시와 고정 카메라는 서로 충돌합니다. 샷이 길수록 원본 프레임에서 멀어지므로 12초로 늘리기 전에 4~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-1.5-pro/image-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"generate_audio": true,
"image_url": "https://example.com/reference.png",
"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 레퍼런스에서 확인하세요.
















