Seedance 2.0 Fast API

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

Seedance 2.0 Fast는 ByteDance Seedance 2.0 라인의 고속 등급입니다. 세 엔드포인트 모두 480p 또는 720p의 4~15초 클립을 돌려주며, 오디오도 화면과 함께 생성합니다.

시작 자료로 Seedance 2.0 Fast 모드 고르기

같은 필드, 세 가지 소스

세 엔드포인트는 모두 같은 기본 필드를 받습니다. prompt, 4~15초의 duration_seconds(-1이면 모델이 길이를 정합니다), 480p 또는 720p의 resolution, aspect_ratio, generate_audio, seed입니다. 달라지는 것은 화면을 고정하는 소스뿐이며, 없음, 시작 프레임, 레퍼런스 묶음 중 하나입니다. 그 소스를 더하거나 빼기만 하면 요청을 다른 모드로 옮길 수 있습니다.

화면과 소리를 한 번에

generate_audio는 기본으로 켜져 있으며 앰비언스, 움직임 효과음, 목소리를 프레임에 맞춰 생성합니다. 이 등급에서는 꺼도 요금이 내려가지 않으므로 무음 루프나 후반 작업에서 음악을 입힐 소재일 때만 끄면 됩니다.

기본은 적응형 화면비

aspect_ratio의 기본값은 adaptive입니다. 이미지→영상은 시작 프레임의 비율을 유지하고, 레퍼런스→영상은 주 레퍼런스를 따르며, 텍스트→영상은 프롬프트가 암시하는 형태를 모델이 고릅니다. 게재 위치가 형태를 정해 두었다면 16:9, 9:16, 4:3, 3:4, 1:1, 21:9 여섯 가지 고정 비율을 쓰면 됩니다.

자체 프레임에서 문자 그대로의 결과

시작 프레임에 담긴 것은 이미 클립에 들어 있으므로, 프롬프트는 움직임만 설명하면 되고 내용을 말로 설득할 필요가 없습니다. 같은 장면을 글로 쓰면 Seedance 자체 필터가 거절할 때 믿고 쓸 수 있는 방법입니다.

비포 앤 애프터와 트랜지션

image_url과 함께 last_image_url을 보내면 샷은 끝 이미지에 도착해야 합니다. 공개된 예시는 카메라를 고정한 채 10초 동안 빈 방에 러그, 소파, 램프를 채웁니다. 리모델링 공개나 제품 변신을 보여 주는 형태입니다.

480p로 시험하고 720p로 납품

동작과 구도가 읽힐 때까지 저렴한 480p로 돌리고, 남길 테이크는 같은 요청을 720p로 다시 실행하십시오. 해상도는 납품 형식만 바꿀 뿐 시작 프레임에 없는 디테일을 더하지 않습니다.

# 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-fast/image-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "bitrate_mode": "standard",
    "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"
  }
}'

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