Seedance 2.0 Mini API

Seedance 2.0 Mini 이미지→영상은 직접 준비한 그림에서 클립을 시작해 최대 15초까지 움직입니다. 끝 이미지를 더하면 샷이 그곳에 도착해야 하므로 트랜지션을 반복 가능한 방식으로 만들 수 있습니다.

Seedance 2.0 Mini는 ByteDance Seedance 2.0 라인에서 가장 작은 등급입니다. Seedance 2.0 Fast와 같은 세 엔드포인트를 공개하며, 480p 또는 720p의 4~15초 클립을 같은 패스에서 만든 오디오와 함께 돌려줍니다.

시작 자료로 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 새 샷의 시작 프레임이 되고, 두 부분이 합쳐진 파일 하나가 돌아옵니다. 각 단계는 더한 초만큼만 과금되며, 합쳐진 결과는 다시 연장할 수 있습니다.

카탈로그 사진에 움직임을

평면적인 제품 사진이나 진열대 사진이 재촬영 없이 몇 초의 움직임이 됩니다. 공개된 예시는 카메라를 고정한 채 4초 동안 냉장 진열대에 캔을 하나씩 채우며, 작은 금속음과 냉장고 소음도 함께 담았습니다.

두 프레임 사이의 타임랩스

last_image_url을 쓰면 클립이 끝 이미지에 도착해야 합니다. 예시 중 하나는 같은 오솔길을 10초 동안 늦여름에서 깊은 가을로 바꾸며, 카메라는 고정이고 컷은 없습니다.

텍스트 필터가 거절할 장면

내용은 시작 프레임이 담고 있으므로 프롬프트는 움직임만 설명하면 됩니다. 글로 쓴 장면을 Seedance 자체 레이어가 거절할 때는 시작 프레임에서 출발하는 것이 해법입니다.

# 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/image-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "bitrate_mode": "standard",
    "duration_seconds": 5,
    "enable_web_search": false,
    "generate_audio": true,
    "image_url": "https://example.com/reference.png"
  }
}'

# 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 레퍼런스에서 확인하세요.