Seedance 2.0 Mini API

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

레퍼런스 한 세트로 시리즈 전체를

한 남자를 정면, 3/4 측면, 옆모습에서 찍은 세 장과 앞치마를 담은 네 번째 이미지가 있으면 요청마다 프롬프트만 바꿔 시리즈 전체를 이어 갈 수 있습니다. 공개된 빵집 예시가 바로 이렇게 구성되어 있습니다.

클립에서 빌려 온 템포

레퍼런스 클립은 내용 대신 리듬을 제공할 수도 있습니다. 한 예시는 클립의 여유 있고 끊김 없는 푸시인을 가져와 레퍼런스 이미지 속 통로에서 연출하고, 발소리를 레퍼런스 트랙의 박자에 맞춥니다. 9:16으로 8초입니다.

각도가 바뀌어도 같은 커플

같은 커플의 이미지 세 장이 있으면 얼굴과 의상을 유지한 채 새 샷에서 세 번째 각도를 만들 수 있습니다. 480p로 생성한 공원 벤치 예시가 그렇습니다.

# 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/reference-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "bitrate_mode": "standard",
    "duration_seconds": 5,
    "enable_web_search": false,
    "generate_audio": true,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "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 레퍼런스에서 확인하세요.