Seedance 2.5 API

Seedance 2.5 영상 연장은 이미 가진 클립을 이어 갑니다. 클립을 video_url로 보내고 다음에 일어날 일을 프롬프트로 적어 주세요. 플랫폼은 클립의 마지막 최대 30초(더 짧으면 클립 전체)를 레퍼런스 영상으로 Seedance 2.5 reference-to-video에 넘깁니다. 모델이 장면을 이어 가는 4~30초 분량의 새 구간을 만들고, 둘을 MP4 하나로 이어 붙입니다. 원본 전체가 먼저, 이어지는 부분이 뒤에 옵니다. 새 구간도 별도 파일로 돌아오므로 계속 연장하거나 부분별로 편집할 수 있습니다.

연속성은 프레임 한 장이 아니라 영상 자체에서 나옵니다. Seedance는 클립 끝부분의 움직임, 카메라 방향, 소리를 맥락으로 읽기 때문에, 정지 이미지 한 장만 보는 경우보다 속도와 방향이 잘 이어집니다. 새 첫 프레임은 마지막 프레임을 복사한 것이 아니라 생성한 것입니다. 이어 갈 움직임을 적고 카메라 언어를 맞춰 주세요.

모델이 읽는 분량과 만드는 분량에만 비용을 냅니다. 요금은 Seedance 2.5 reference-to-video의 레퍼런스 영상 포함 초당 요금이며, 레퍼런스 초와 새로 만든 초의 합에 붙습니다. 레퍼런스 상한은 30초이므로, 60초 원본이라도 레퍼런스로 과금되는 것은 30초이고 그 앞부분은 읽고 다시 붙이기만 합니다. 레퍼런스 초는 초 단위로 올림하며 Seedance 자체의 최소 과금도 적용됩니다. 5초 구간이면 레퍼런스는 최소 4초입니다.

파일 하나와 새 부분 단독 파일을 돌려 드립니다. 합쳐진 파일은 클립의 프레임 레이트와 화면 구도를 유지하고 검은 띠 없이 H.264 MP4와 AAC 소리로 인코딩됩니다. 이음새를 맞추기 위해 화면 가장자리가 몇 퍼센트 정도 잘리거나 조정될 수 있습니다. 모델이 돌려준 영상의 화면 비율이 눈에 띄게 다르면 새 구간을 화면에 꽉 차게 확대해 가운데에 맞추고, 넘치는 부분은 잘라 냅니다. 원본의 소리는 남고, 새 구간에서 생성한 소리는 이음매에서 짧게 페이드하며 이어지며, 한쪽이 무음이면 무음으로 채웁니다. 출력의 두 번째 에셋은 새 구간만 담습니다.

나머지는 모두 Seedance 2.5 reference-to-video와 같습니다. 새 구간은 그 엔드포인트와 같은 경로, 같은 콘텐츠 허용 범위로 생성되고, 생성에 실패하면 같은 방식으로 환불됩니다. 생성은 성공했지만 이어 붙이기만 실패하면 작업은 실패 처리되고 요금은 환불됩니다. 2초보다 짧은 클립은 너무 짧아 이어 갈 수 없으므로 받지 않습니다.

너무 일찍 끝난 숏을 늘릴 수 있습니다. 동작 중간에 멈춘 춤, 인물이 문에 닿기 전에 끊긴 이동 촬영, 라벨이 카메라를 향하기 전에 멈춘 제품 회전 같은 경우입니다. 연장하고 남은 동작을 적어 주세요.

긴 시퀀스를 한 단계씩 쌓아 올릴 수 있습니다. 첫 숏을 만들고 연장한 다음, 이어 붙인 결과를 다시 연장합니다. 단계마다 읽는 레퍼런스(최대 30초)와 추가한 초가 과금됩니다. 원본은 최대 60초이므로 길게 이어 갈 때는 이어 붙인 전체가 아니라 가장 최근 구간을 연장하세요.

# 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/video-extend",
  "input": {
    "duration_seconds": 5,
    "generate_audio": true,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p",
    "video_url": "https://example.com/reference.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 레퍼런스에서 확인하세요.