Seedance 2.5 API: 30초 클립, 해상도, 레퍼런스

Sume API에서 Seedance 2.5는 POST /v1/videos의 모델 ID seedance-2.5이며, 480p, 720p, 1080p의 4–30초 클립을 만듭니다. 나머지 계열인 seedance-2, seedance-2-fast, seedance-2-mini는 15초까지이고, 문서는 이 셋 중 seedance-2에만 1080p를 나열합니다.

아래 한도는 모두 2026-09-27에 확인한 Sume의 영상 생성 (영문)과 Video Router (영문) 문서, Sume API 레퍼런스에서 가져왔습니다. Sume 밖의 Seedance와 그 공급사 가격은 Sume vs Seedance를, 모든 모델의 길이는 모델별 AI 영상 길이 한도를 참고하세요.

어떤 Seedance ID를 호출할 수 있고, 한도는 어떻게 되나요?

네 ID 모두 POST /v1/videos와 레거시 POST /v1/video-router/generate에서 동작합니다. 레거시 엔드포인트는 같은 ID를 image_url, reference_image_urls 같은 평면 필드와 함께 받으며, 문서는 새 연동에 /v1/videos를 쓰라고 안내합니다. 문서화된 한도는 ID마다 다릅니다.

30초 Seedance 2.5 클립은 어떻게 요청하나요?

15초를 넘는 유일한 Seedance ID인 model: "seedance-2.5"와 함께 duration: 30을 보내세요. duration은 정수 초 단위이며, resolution과 aspect_ratio는 모델이 공개한 값이어야 합니다. 아래 요청은 레퍼런스 영상을 따르는 30초 1080p 클립을 요청합니다. 제출 후 폴링하는 흐름과 목록에 없는 길이를 보냈을 때의 오류는 모델별 AI 영상 길이 한도에서 다룹니다.

• resolution은 명시적으로 보내세요. API 레퍼런스에 따르면 Video Router에서는 이 값을 생략하면 프로바이더나 런타임 기본값이 적용됩니다.
• 문서의 seedance-2 예시 디스크립터는 21:9, 16:9, 4:3, 1:1, 3:4, 9:16의 여섯 가지 화면 비율을 나열합니다. /v1/videos enum에도 있는 2:3, 3:2, 9:21은 여기에 없습니다. seedance-2.5 자체의 목록은 GET /v1/videos/models에서 확인하세요.

curl -X POST https://api.sume.com/v1/videos \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-25-30s-001" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A ceramic mug on a stone plinth, the camera moving like the reference clip",
    "duration": 30,
    "resolution": "1080p",
    "aspect_ratio": "9:16",
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/camera-move.mp4" } }
    ]
  }'

생성 모드마다 어떤 입력을 받나요?

보내는 필드가 모드를 정합니다. 모델별 레퍼런스 비교는 Reference-to-Video API에서 다룹니다.

• 텍스트로 영상 만들기: API 레퍼런스의 seedance-2.5와 seedance-2-mini 예시처럼 prompt만 보냅니다.
• 이미지로 영상 만들기: frame_images에 항목을 최대 두 개 넣고, 각 항목의 frame_type은 first_frame이나 last_frame입니다. 문서의 seedance-2 디스크립터는 두 타입을 모두 나열합니다.
• 레퍼런스로 영상 만들기: input_references에 최대 12개를 넣으며, 타입은 image_url, video_url, audio_url 중 하나입니다. 문서에 따르면 Seedance 2.x 모델은 오디오와 영상 레퍼런스를 반영하며, 타입은 모델의 supported_input_references에 있어야 합니다.
• 둘 다 보내면: frame_images가 우선하며, 요청은 이미지로 영상 만들기로 실행됩니다.

Seedance는 오디오를 생성하나요?

생성할 수 있습니다. generate_audio의 기본값은 모델의 오디오 기능을 따릅니다. 문서는 seedance-2를 “text/image/reference-to-video with optional audio”(오디오를 선택할 수 있는 텍스트·이미지·레퍼런스 기반 영상 생성)이라고 설명하고 디스크립터에 generate_audio: true를 보여 주며, API 레퍼런스 예시는 seedance-2.5에 generate_audio: true를, seedance-2-mini에 false를 보냅니다. 무음 클립이 필요하면 false를 명시적으로 보내세요.

Sume의 Seedance가 받지 않는 것은 무엇인가요?

Seedance에서는 다음 항목이 거부되거나 문서화되어 있지 않습니다.

• seed: 이 필드를 받는 v1 모델은 없으며, 모든 모델이 이 필드를 거부합니다.
• size: 픽셀 크기는 400 unsupported_parameter를 반환합니다. resolution과 aspect_ratio를 쓰세요.
• 비어 있지 않은 provider.options: 역시 400 unsupported_parameter를 반환합니다.
• 편집할 클립: API 레퍼런스는 영상 편집(video-to-video)을 gemini-omni-flash-1.1에만 나열합니다.
• seedance-2-fast나 seedance-2-mini의 1080p: 문서화되어 있지 않습니다. 문서와 API 레퍼런스는 Seedance ID 중 seedance-2.5와 seedance-2에만 1080p를 명시합니다.
• seedance-2.5를 제외한 모든 Seedance ID에서 15초를 넘는 길이.

Seedance는 어떻게 과금되나요?

영상 토큰 단위로 과금됩니다. 문서의 seedance-2 디스크립터는 pricing_skus에 per-1000-video-tokens 요율을 나열하고, GET /v1/videos/models는 ID마다 고유한 요율을 보여 줍니다. 과금액은 공급사 정가 × 1.25이며 제출 시 예약되고, 기본적으로 5.5% 에이전트 수수료가 더해집니다. Seedance를 직접 구매하는 경우와의 비교는 Sume vs Seedance에서 다룹니다. 1080p 클립은 API 요금을 참고하고, Job이 완료되면 폴링 응답의 usage.cost(Sume 청구 금액)을 읽으세요.