Seedance 에셋 라이브러리

Seedance 2.0는 신뢰 가능한 참조 에셋에서 비디오를 생성합니다 — 얼굴, 의상, 제품, 음성. 생성을 일관되고 규정에 부합하게 유지하기 위해, 이러한 참조 에셋은 모델이 추론 시점에 신뢰하는 비공개 에셋 라이브러리에 저장됩니다. OrcaRouter는 이 라이브러리를 /v1/asset 으로 노출합니다. 이 페이지는 라이브러리가 어떻게 작동하는지 와 무엇이 필요한지 를 설명합니다. 정확한 엔드포인트, 파라미터, 그리고 직접 실행해 보는 콘솔은 API Reference → Seedance Assets 를 참고하세요.

라이브러리 구조

에셋 그룹(Asset Group) — 컨테이너입니다. 실제 인물 그룹의 경우 하나의 그룹이 한 명의 실제 인물에 매핑되며, 가상 그룹의 경우 논리적 그룹화입니다(예: 하나의 캐릭터).
에셋(Asset) — 그룹 안에 있는 단일 파일(이미지, 비디오 또는 오디오)입니다. Active 상태에 도달한 에셋만 비디오 생성에 참조할 수 있습니다.

준비된 에셋은 비디오 요청에서 asset://<asset_id> 로 참조합니다.

두 가지 종류의 그룹

업로드와 관리 작업은 두 종류 모두 동일합니다. 차이는 오직 그룹을 생성하는 방식에만 있습니다.

	가상(AIGC)	실제 인물(LivenessFace)
용도	가상 / AI 캐릭터, 소품, 장면	실제 인물의 외형
생성 방식	직접 생성 호출	해당 인물이 수행하는 일회성 얼굴 검증
이유	보호할 신원이 없음	초상권 — 동의가 원천에서 수집됨

두 라이브러리 모두 Advanced Creation Rights 가 필요하며, 용량 쿼터는 둘 사이에서 공유됩니다. 실제 인물 라이브러리는 초대받은 계정에 제공됩니다.

에셋 파일 요구사항

에셋은 공개적으로 접근 가능한 URL 로 제공됩니다(파일 업로드 없음, base64 없음). 제한사항:

유형	형식	제약
이미지	jpeg, png, webp, bmp, tiff, gif, heic/heif	종횡비(W/H) 0.4–2.5 · 한 변당 300–6000 px · < 30 MB
비디오	mp4, mov	480p/720p/1080p · 2–15 s · 종횡비 0.4–2.5 · 300–6000 px · 총 픽셀 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
오디오	wav, mp3	2–15 s · ≤ 15 MB

초상 콘텐츠 모범 사례(얼굴 일관성을 위해):

전신 참조: 세로 방향, 인물의 전신 정면 샷.
얼굴 클로즈업: 세로 방향, 무표정, 어깨 위로 프레이밍하여 얼굴이 프레임의 약 3분의 2를 채우도록.

같은 인물의 우수한 참조 여러 개를 하나의 그룹에 업로드하면 생성된 비디오가 그 인물의 얼굴과 의상을 얼마나 충실하게 재현하는지가 향상됩니다.

에셋 라이프사이클(업로드는 비동기)

에셋을 업로드하면 즉시 asset_id 와 함께 반환되며, 파일은 이후 백그라운드에서 전처리됩니다. Status 가 안정될 때까지 에셋을 폴링하세요:

Processing — 아직 전처리 중입니다. 계속 폴링하세요.
Active — 준비됨. 비디오 생성에 사용하세요.
Failed — 전처리에서 거부됨. Error 를 확인하세요(예: 형식/크기, 콘텐츠 검열 차단, 또는 — 실제 인물 그룹의 경우 — FaceMismatch).

업로드 시간에 대한 SLA는 보장되지 않으며, 비디오 에셋은 이미지보다 더 오래 걸립니다. 에셋에 대해 반환되는 서명된 다운로드 URL 은 임시적입니다(약 12시간).

실제 인물 검증 플로우

실제 인물 그룹은 해당 인물이 한 번 본인 확인을 수행함으로써 생성됩니다. 귀하의 백엔드는 얼굴 데이터를 절대 처리하지 않으며, 플로우를 오케스트레이션하기만 합니다:

세션 시작

귀하의 백엔드가 OrcaRouter에 검증 세션 시작을 요청합니다. H5 링크(호스팅된 얼굴 확인 페이지)와 session_id 를 돌려받습니다.

본인 검증

H5 링크를 최종 사용자에게 전달합니다. 사용자는 자신의 기기에서 — OrcaRouter 로그인 불필요 — 열어 얼굴 확인을 완료합니다. 한 번 승인하면, 이후 같은 인물의 새로운 모습은 재검증 없이 같은 그룹에 추가할 수 있습니다.

그룹 생성

성공 시, 검증 페이지가 최종 사용자의 브라우저를 OrcaRouter 콜백으로 리디렉션하고(자동 처리), 새 그룹이 귀하를 위해 등록됩니다. return_url 을 전달했다면 사용자는 귀하의 페이지로 돌아갑니다.

결과 폴링

귀하의 백엔드는 status 가 success(새 group_id 포함)이거나 failed 가 될 때까지 세션을 폴링합니다. 그런 다음 가상 그룹과 정확히 동일하게 에셋을 업로드하고 비디오를 생성합니다.

얼굴 일관성. 실제 인물 그룹에 이미지를 업로드하면, 검증된 참조와 비교됩니다. 다른 인물(또는 한 이미지에 여러 얼굴)은 거부되며 — 에셋은 Failed / FaceMismatch 로 귀결됩니다. 그룹의 이름과 설명은 생성 후 그룹 업데이트 작업을 통해 설정할 수 있습니다.

쿼터

귀하의 계정에는 최대 에셋 수(기본값 100, 모든 그룹 합산)가 있습니다. 상한을 초과하는 업로드는 403 으로 거부됩니다.

비디오 생성에서 에셋 참조하기

에셋이 Active 가 되면, Seedance 비디오 요청의 metadata.content[] 에서 asset://<asset_id> 로 참조하고, 프롬프트에서는 유형 + 위치([Image 1], [Video 1], [Audio 1])로 가리키세요 — 원시 asset id로는 절대 가리키지 마세요:

{
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "prompt": "The girl in [Image 1] arranges items on the counter.",
  "metadata": {
    "content": [
      { "type": "image_url", "role": "reference_image",
        "image_url": { "url": "asset://asset-20260318071009-xy98z" } }
    ]
  }
}

API Reference → Seedance Assets — 모든 엔드포인트, 전체 파라미터, 그리고 인터랙티브 플레이그라운드(요청/응답 샘플이 여기에 있습니다).
Seedance 비디오 — 이러한 에셋을 소비하는 비디오 생성 엔드포인트.

​라이브러리 구조

​두 가지 종류의 그룹

​에셋 파일 요구사항

​에셋 라이프사이클(업로드는 비동기)

​실제 인물 검증 플로우

​쿼터

​비디오 생성에서 에셋 참조하기

​다음

라이브러리 구조

두 가지 종류의 그룹

에셋 파일 요구사항

에셋 라이프사이클(업로드는 비동기)

실제 인물 검증 플로우

쿼터

비디오 생성에서 에셋 참조하기

다음