Skip to main content
POST
seedance-2.5-ext 비디오 생성
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
seedance-2.5-ext 는 Seedance 2.5 패밀리의 프로모션 채널 모델로, 텍스트-투-비디오와 멀티모달 레퍼런스 생성을 지원합니다:
  • 텍스트-투-비디오 및 레퍼런스 이미지 생성
  • 레퍼런스 비디오와 레퍼런스 오디오 결합 생성(비디오 편집, 연장, 첫/마지막 프레임 모드는 미지원)
  • API는 비동기 작업입니다: 제출하면 generation.task 가 반환되고, 완료 후 비디오 작업 상태 API로 결과를 가져옵니다.
요청 내용에 따라 최적의 업스트림으로 자동 라우팅됩니다: 이미지만 있거나 텍스트만 있는 요청은 저비용 업스트림으로, 레퍼런스 비디오·레퍼런스 오디오·11장 이상의 레퍼런스 이미지가 포함된 요청은 전체 기능 업스트림으로 전달됩니다.

인증

string
필수
Bearer Token으로 인증합니다:

요청 파라미터

string
기본값:"seedance-2.5-ext"
필수
ToAPIs 공개 모델명. 항상 seedance-2.5-ext 를 사용하세요.
string
장면, 카메라 움직임, 피사체 동작, 스타일, 사운드 분위기를 설명합니다. 에셋을 참조할 때는 배열 순서에 맞춰 “이미지1”, “비디오1”, “오디오1” 같은 태그를 사용할 수 있습니다.
integer
출력 비디오 길이(초). 10–30 범위. 호환 필드 duration 도 사용할 수 있으며, 둘을 함께 전달하지 마세요.
레퍼런스 비디오, 레퍼런스 오디오 또는 11장 이상의 레퍼런스 이미지가 포함된 요청에서는 15 초를 지원하지 않습니다. 텍스트만 있거나 이미지가 10장 이하인 요청은 영향을 받지 않습니다.
string
출력 화면 비율. 16:9, 9:16, 4:3, 3:4, 1:1 을 지원합니다. 호환 필드 aspect_ratio 도 사용할 수 있습니다.
string
기본값:"720p"
출력 해상도. 720p 고정입니다.
string
단일 레퍼런스 이미지의 공개 URL. 여러 장일 경우 reference_images 를 사용하세요.
string[]
레퍼런스 이미지 URL 배열. 최대 30 장. image_with_roles(role 은 reference_image)로 명시적으로 전달할 수도 있습니다.
object[]
레퍼런스 비디오 배열. 최대 10 개. 각 항목:
  • url: 공개 접근 가능한 비디오 URL
  • role: reference_video 고정
object[]
레퍼런스 오디오 배열. 최대 10 개. 각 항목:
  • url: 공개 접근 가능한 오디오 URL
  • role: reference_audio 고정
오디오는 단독 입력으로 사용할 수 없습니다. 요청에 레퍼런스 이미지 또는 레퍼런스 비디오가 하나 이상 포함되어야 합니다.
string
ToAPIs 작업 완료 콜백 URL. 자세한 내용은 작업 Webhook을 참조하세요.
string
고객 측 주문 번호 또는 비즈니스 작업 ID. 작업과 함께 저장되며 GET /v1/videos/generations/{client_business_id} 로도 조회할 수 있습니다.
string
호출자가 정의하는 트레이스 ID.

에셋 조합 규칙

요청 예시

텍스트-투-비디오

레퍼런스 이미지로 생성

비디오와 오디오 결합 레퍼런스

응답

string
상태 조회용 작업 ID.
string
요청에 지정한 경우 반환됩니다.
string
항상 generation.task 입니다.
string
이 요청에 사용된 모델명.
string
queued, in_progress, completed 또는 failed.
integer
0–100 의 작업 진행률.
integer
생성 타임스탬프.