Seedance 2.5 · 비디오 생성

엔드포인트	메서드	경로
작업 제출	POST	/v1/videos/generations
결과 조회	GET	/v1/videos/generations/{id}

요청 파라미터

Authorization

Header에 Authorization을 추가하고 값은 Bearer 뒤에 API 키를 붙입니다.

Authorization: Bearer ****************

Header 파라미터

Content-Typestring선택

application/json

Acceptstring선택

application/json

Body 파라미터application/json필수

modelstring필수

모델 ID, `dreamina-seedance-2.5` 로 고정

contentarray[object]필수

BytePlus 네이티브 입력 배열(권장 주 사용법)로, 아래 5가지 type을 조합해 사용합니다. role은 type과 같은 레벨인 content item 바깥에 두며, image_url/video_url 하위 객체 안에는 넣지 않습니다. role 값: 이미지 first_frame/last_frame/reference_image, 비디오 reference_video.

callback_urlstring선택

작업 상태 변경 시 콜백 알림 주소(선택)

return_last_frameboolean선택

동영상 마지막 프레임 이미지 반환 여부(기본 false)

resolutionstring선택

480p / 720p / 1080p / 4k동영상 해상도(기본 720p; 4k는 Seedance 2.0만)

ratiostring선택

16:9 / 4:3 / 1:1 / 9:16 / 21:9 / adaptive생성 동영상의 종횡비(기본 adaptive)

durationinteger선택

동영상 길이(초), 기본 5

seedinteger선택

랜덤 시드, 기본 -1(랜덤); 범위 [-1, 2^32-1]

camera_fixedboolean선택

카메라 고정 여부(기본 false)

watermarkboolean선택

워터마크 추가 여부(기본 false)

service_tierstring선택

default / flex서비스 등급: default(온라인 추론) / flex(오프라인, 반값; Seedance 2.0 시리즈 미지원)

execution_expires_afterinteger선택

작업 타임아웃(초), created_at 기준; 기본 172800(48h), 범위 [3600, 259200]

generate_audioboolean선택

출력에 동기화 오디오 포함 여부(기본 true; Seedance 2.0 시리즈 / 1.5 Pro만)

draftboolean선택

초안 모드 활성화(기본 false; Seedance 1.5 Pro만; 초안은 480p 고정)

safety_identifierstring선택

플랫폼 위험 탐지를 위한 엔드유저 고유 식별자

예시

{  "model": "dreamina-seedance-2.5",  "content": [    {      "type": "text",      "text": "바위에 부딪치는 파도의 슬로모션, 따뜻한 노을 톤"    }  ],  "resolution": "720p",  "ratio": "16:9",  "duration": 5,  "seed": 11,  "camera_fixed": false,  "watermark": false}

요청 코드 예시

curl https://api.hotrouter.ai/v1/videos/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "dreamina-seedance-2.5",    "content": [      {        "type": "text",        "text": "바위에 부딪치는 파도의 슬로모션, 따뜻한 노을 톤"      }    ],    "resolution": "720p",    "ratio": "16:9",    "duration": 5,    "seed": 11,    "camera_fixed": false,    "watermark": false  }'

응답

작업 제출

{  "id": "cgt-xxxxxxxx",  "status": "queued"}

결과 조회

{  "id": "cgt-xxxxxxxx",  "status": "succeeded",  "content": {    "video_url": "https://.../video.mp4"  },  "usage": {    "completion_tokens": 0  }}

엔드포인트	메서드	경로
작업 제출	POST	/v1/videos/generations
결과 조회	GET	/v1/videos/generations/{id}

요청 파라미터

Authorization

Header에 Authorization을 추가하고 값은 Bearer 뒤에 API 키를 붙입니다.

Authorization: Bearer ****************

Header 파라미터

Content-Typestring선택

application/json

Acceptstring선택

application/json

Body 파라미터application/json필수

modelstring필수

모델 ID, `dreamina-seedance-2.5` 로 고정

contentarray[object]필수

callback_urlstring선택

작업 상태 변경 시 콜백 알림 주소(선택)

return_last_frameboolean선택

동영상 마지막 프레임 이미지 반환 여부(기본 false)

resolutionstring선택

480p / 720p / 1080p / 4k동영상 해상도(기본 720p; 4k는 Seedance 2.0만)

ratiostring선택

16:9 / 4:3 / 1:1 / 9:16 / 21:9 / adaptive생성 동영상의 종횡비(기본 adaptive)

durationinteger선택

동영상 길이(초), 기본 5

seedinteger선택

랜덤 시드, 기본 -1(랜덤); 범위 [-1, 2^32-1]

camera_fixedboolean선택

카메라 고정 여부(기본 false)

watermarkboolean선택

워터마크 추가 여부(기본 false)

service_tierstring선택

default / flex서비스 등급: default(온라인 추론) / flex(오프라인, 반값; Seedance 2.0 시리즈 미지원)

execution_expires_afterinteger선택

작업 타임아웃(초), created_at 기준; 기본 172800(48h), 범위 [3600, 259200]

generate_audioboolean선택

출력에 동기화 오디오 포함 여부(기본 true; Seedance 2.0 시리즈 / 1.5 Pro만)

draftboolean선택

초안 모드 활성화(기본 false; Seedance 1.5 Pro만; 초안은 480p 고정)

safety_identifierstring선택

플랫폼 위험 탐지를 위한 엔드유저 고유 식별자

예시

{
  "model": "dreamina-seedance-2.5",
  "content": [
    {
      "type": "text",
      "text": "바위에 부딪치는 파도의 슬로모션, 따뜻한 노을 톤"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "seed": 11,
  "camera_fixed": false,
  "watermark": false
}

{  "model": "dreamina-seedance-2.5",  "content": [    {      "type": "text",      "text": "바위에 부딪치는 파도의 슬로모션, 따뜻한 노을 톤"    }  ],  "resolution": "720p",  "ratio": "16:9",  "duration": 5,  "seed": 11,  "camera_fixed": false,  "watermark": false}

요청 코드 예시

curl https://api.hotrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2.5",
    "content": [
      {
        "type": "text",
        "text": "바위에 부딪치는 파도의 슬로모션, 따뜻한 노을 톤"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": 11,
    "camera_fixed": false,
    "watermark": false
  }'

curl https://api.hotrouter.ai/v1/videos/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "dreamina-seedance-2.5",    "content": [      {        "type": "text",        "text": "바위에 부딪치는 파도의 슬로모션, 따뜻한 노을 톤"      }    ],    "resolution": "720p",    "ratio": "16:9",    "duration": 5,    "seed": 11,    "camera_fixed": false,    "watermark": false  }'

응답

작업 제출

{
  "id": "cgt-xxxxxxxx",
  "status": "queued"
}

{  "id": "cgt-xxxxxxxx",  "status": "queued"}

결과 조회

{
  "id": "cgt-xxxxxxxx",
  "status": "succeeded",
  "content": {
    "video_url": "https://.../video.mp4"
  },
  "usage": {
    "completion_tokens": 0
  }
}

{  "id": "cgt-xxxxxxxx",  "status": "succeeded",  "content": {    "video_url": "https://.../video.mp4"  },  "usage": {    "completion_tokens": 0  }}

Seedance 2.5 · 비디오 생성

요청 파라미터

요청 코드 예시

응답

On this page

Seedance 2.5 · 비디오 생성

요청 파라미터

요청 코드 예시

응답

On this page