Seedance 2.5 안내 - GravitexAI Documentation

소개

Seedance 2.5(model: "seedance-2-5")는 Seedance 2.0과 동일한 엔드포인트(Base URL, 인증, 자산 라이브러리, 작업 조회, 응답 형식 모두 동일)를 공유합니다. 비디오 생성 작업 생성 시 model을 seedance-2-5로 바꾸기만 하면 호출할 수 있습니다. 이 페이지에는 2.5가 2.0과 다른 점만 정리되어 있습니다. 여기에 언급되지 않은 부분(인증, 자산 라이브러리, 폴링, 오류 코드 등)은 2.0과 완전히 동일하며 아래 문서를 참고하세요:

비디오 생성 작업 생성(기본 파라미터, content 배열 구조, 상호 배타 규칙)
비디오 생성 작업 조회
자산 그룹 생성 / 자산 생성
검수 차단 사유 조회

주요 차이점

항목	Seedance 2.0	Seedance 2.5
`duration`	`-1` 또는 `4`~`15`초	`-1` 또는 `4`~`30`초
참조 이미지 `reference_image`	최대 9개	최대 30개
참조 비디오 `reference_video`	최대 3개, 총 길이 ≤ 15초	최대 10개
참조 오디오 `reference_audio`	최대 3개	최대 10개
비디오 편집 / 비디오 연장	미지원	지원, 아래 “규칙” 참고
`output_format`	`mp4` 고정	`mov` 선택 가능(신규)
`resolution`(현재 지원)	`480p` / `720p` / `1080p` / `4K`	`480p` / `720p` / `1080p`

참조 자산 수량 상한 및 시간 상한 확대는 Seedance 2.5 업스트림 모델의 기능입니다. 자세한 내용은 Dreamina Seedance 2.5 tutorial을 참고하세요. duration과 참조 자산 수량 제한은 이미 업스트림을 따라 확대되었으며, resolution 과금 등급은 위 표 및 실제 주문 페이지 기준입니다.

규칙

Seedance 2.5에는 별도의 작업 유형 파라미터가 없습니다. 대신 content에 포함된 미디어 자산의 role과 프롬프트에 담긴 의도를 바탕으로 요청이 아래 표 중 어떤 작업에 해당하는지 자동으로 판별합니다. 작업 유형에 따라 ratio, duration의 허용 범위도 달라집니다:

작업 유형	트리거 조건	`ratio`	`duration`
텍스트-투-비디오	참조 자산이 전혀 없고 텍스트 프롬프트만 있음	특정 비율 또는 `adaptive`	`-1` 또는 `4`~`30`
참조 비디오 생성	`reference_image`, `reference_video`, `reference_audio` 중 하나 이상을 제공하고, 프롬프트에 편집/연장 의도가 없음	특정 비율 또는 `adaptive`	`-1` 또는 `4`~`30`
비디오 편집	참조 자산을 제공하고, 프롬프트에 추가·삭제·교체·수정·리페인트·복원 등 편집 의도가 있음	반드시 `adaptive`	반드시 `-1`
비디오 연장	참조 자산을 제공하고, 프롬프트에 앞/뒤로 연장·이어서·계속 등 연장 의도가 있음	반드시 `adaptive`	`-1` 또는 `4`~`30`
첫 프레임/첫-마지막 프레임 비디오	이미지를 `first_frame`으로 제공, `last_frame`을 함께 제공 가능	반드시 `adaptive`	`-1` 또는 `4`~`30`

요청 예제(표준 텍스트-투-비디오 / 이미지-투-비디오)

2.0과 사용법이 완전히 동일하며 model만 교체하면 됩니다:

curl -X POST "https://api.gravitex.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "content": [
      {"type": "text", "text": "Golden hour drone shot over rolling mountains, clouds rolling by"}
    ],
    "duration": 20,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'

파라미터 설명, content 배열 구조, 자산 asset:// 매핑 규칙 등은 비디오 생성 작업 생성을 참고하세요. 다음 단계: 비디오 생성 작업 조회