간단한 답변
Seedance는 요청 내 각 항목의role만 읽습니다. 도구에서 어떤 스위치를 선택했는지는 인식하지 못하며, 이를 확인하기 위해 prompt를 읽지도 않습니다. role이 없는 이미지는 첫 번째 프레임(image-to-video)으로 처리됩니다. 여기에 참조 동영상을 추가하면 요청이 ‘첫 번째 프레임 + 참조 미디어’가 되어 제공자 측에서 거부됩니다.
제출 시 일반적으로 400 오류가 반환됩니다. 작업은 생성되지 않으며 과금도 발생하지 않습니다:
POST /seedance/api/v3/contents/generations/tasks를 통해 제출하고, 이미지에는 "role": "reference_image", 동영상에는 "role": "reference_video"을 설정하십시오. 그리고 동영상은 제공자가 직접 다운로드할 수 있는 공개 URL로 전달하거나, 에셋 라이브러리에 등록한 후 asset://로 참조하십시오.
실제 사례
한 고객이 직접 제작한 로컬 크리에이티브 도구를 사용하고 있었습니다. 캐릭터 이미지 1장과 동영상 1개를 전달하고, “omni reference”를 선택한 뒤 “first/last frame”은 선택 해제했으며, prompt에는 “이미지 1은 첫 번째 프레임이 아니므로 첫/마지막 프레임 모드를 사용하지 마십시오”라고 작성하기까지 했습니다. 그럼에도 실행할 때마다 위의 오류가 발생하며 실패했습니다. 게이트웨이 측에서 캡처한 원본 요청은 다음과 같습니다(이미지 Base64 생략):
고객의 브라우저 콘솔에도 동일한 mp4에 대해
415 Unsupported Media Type이 표시되었으며, 이는 도구 자체의 로컬 미리보기 엔드포인트(/api/media-preview/...(localhost))에서 발생한 것이었습니다. 도구가 동영상을 사용할 수 있는 주소로 변환하지 못하고 로컬 경로를 요청에 그대로 넣었던 것입니다.
범용 동영상 엔드포인트를 통해 Seedance를 제출하지 마십시오
/v2/videos/generations(및 /v1/videos, /v1/video/generations)는 게이트웨이의 범용 동영상 엔드포인트입니다. 해당 필드는 여러 동영상 모델이 공유하는 공통 하위 집합이며, Seedance의 입력 모드를 표현할 수 없습니다:
role없음: 첫 프레임, 첫/마지막 프레임, 멀티모달 참조를 구분할 수 없으므로, 이미지 1개와 동영상 1개는 항상 “첫 프레임 + 참조”로 처리됩니다- 해상도가 온전히 전달되지 않음: 테스트 결과, 480p로 요청한 2.5는 720p로 출력되었고, 1080p로 요청한 2.0 시리즈는 720p로 출력되었으며, 과금은 실제로 생성된 해상도를 기준으로 이루어집니다
- 2.5 전용 매개변수(
omni_reference_task_type,output_format등)와 일치하는 필드가 없습니다
서드파티 도구를 사용하는 경우, 해당 도구의 Seedance 채널이 “네이티브” 또는 “Volcengine Ark” 형식을 제공하는지 확인하십시오. 범용 동영상 API만 지원하는 도구는 참조 동영상이 포함된 작업을 실행할 수 없습니다.
올바른 방법: 모든 항목에 역할 설정
- 세 가지 입력 모드는 상호 배타적입니다: 첫 프레임/마지막 프레임(이미지 2장,
first_frame/last_frame), 첫 프레임(이미지 1장), 멀티모달 참조(reference_image/reference_video/reference_audio). 참조 동영상이나 참조 오디오가 있는 즉시 모든 이미지는reference_image이어야 합니다. role이 없으면 첫 프레임을 의미합니다:role이 없는 단일 이미지는first_frame과 동일합니다.- prompt에서는 전달된 순서대로 항목을 참조하십시오(예:
@image1및@video1). - 참조 제한: 2.0 시리즈의 경우 최대 이미지 9장 + 동영상 3개 + 오디오 클립 3개이며, 2.5의 경우 최대 이미지 30장 + 동영상 10개 + 오디오 클립 10개입니다.
참조 동영상 전달 방법
제공업체는 자체 서버에서 미디어를 다운로드하므로, 동영상은 제공업체가 직접 접근할 수 있는 주소에 있어야 합니다.
제출하기 전에 인터넷 접속이 가능한 모든 컴퓨터에서 링크를 확인할 수 있습니다(
<URL>을(를) 동영상 링크로 대체하십시오):
code=200, video/mp4 또는 video/quicktime인 type, 그리고 원본 파일과 일치하는 size이 표시되어야 합니다. HTML 페이지, JSON 본문 또는 임의의 4xx는 제공업체가 해당 링크를 사용할 수 없음을 의미합니다. 이미지 링크에 대한 전체 확인 방법은 이미지 링크는 열리지만 실패하는 경우를 참조하십시오.
관련 문서
동영상 생성 API
네이티브 엔드포인트와 각 입력 모드별 콘텐츠 레이아웃 및 역할 값
에셋 우선 워크플로
참조 동영상을 Base64로 전송해서는 안 되는 이유와 에셋 등록 방법