Seedance 2.0 Fast API

Seedance 2.0 Fast 텍스트→영상은 피사체, 세트, 카메라, 조명까지 화면 전체를 프롬프트로 구성하고 사운드트랙도 같은 패스에서 만듭니다. 화면을 고정하는 소재가 없으므로 아직 존재하지 않는 샷을 위한 엔드포인트입니다.

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 여섯 가지 고정 비율을 쓰면 됩니다.

소셜 피드용 세로 컷

9:16을 직접 지정하고 휴대폰이 본 것처럼 샷을 쓰십시오. 손에 든 카메라, 창으로 드는 낮의 빛, 주변 소음은 그대로 둡니다. 아래 예시가 바로 그런 컷으로, 촬영 소스 없이 프롬프트만으로 버스 창가 자리 5초를 만들었습니다.

아무도 찍으러 가지 않을 컷

따라갈 이미지가 없으므로 피사체, 세트, 카메라, 조명의 출처는 프롬프트뿐입니다. 그래서 로케이션과 스태프가 필요했을 설정 샷, 인서트, B롤에 맞는 엔드포인트입니다.

긴 시퀀스의 첫 샷

이 라인에는 연장 엔드포인트가 없습니다. 여기서 첫 샷을 만들고 마지막 프레임을 내보낸 뒤 이미지→영상에 다음 샷의 시작 프레임으로 보내십시오. 의상, 세트, 조명이 그 프레임에 담겨 있어 그대로 이어집니다.

# 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/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "bitrate_mode": "standard",
    "generate_audio": true,
    "duration_seconds": 5
  }
}'

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