에셋 라이브러리가 필요한 이유
캐릭터 일관성이 유지되는 동영상을 생성할 때 Seedance 2.0은 사람 얼굴이 포함된 참조 이미지를 직접 허용하지 않습니다(딥페이크 방지 필터링). 먼저 이미지를 신뢰할 수 있는 에셋으로 등록하고asset://xxx 에셋 ID를 받은 다음, 동영상 생성 요청에서 해당 ID를 참조해야 합니다.
이 서비스가 등록 과정을 대신 처리합니다. 이미지 업로드 → 에셋 ID 받기 → 동영상 생성만 진행하면 됩니다. 사용하는 방법은 두 가지이며, 두 방법의 데이터는 완전히 공유됩니다.
방법 1: 웹 UI(초보자에게 권장)
가입 및 로그인
업로드 및 수집
- 자산 그룹은 선택 사항입니다. 시스템이 기본 그룹을 자동으로 사용합니다. 캐릭터별로 자산을 정리하려면 먼저 그룹을 만드십시오.
- 이미지 요구사항: jpeg / png / webp / bmp / tiff / gif / heic; 종횡비 0.4–2.5; 변 길이 300–6000px; 각 파일 30MB 미만입니다.
자산 ID 복사
asset://xxx 자산 ID를 복사합니다.동영상 생성
asset:// ID를 얻습니다. 같은 배우라도 스타일이 달라져도 같은 그룹을 재사용하므로 재검증이 필요하지 않습니다.

The asset library web UI: the ingest tab for manual uploads, the asset list / archive tab for browsing assets and copying asset:// IDs, and the real-person verification tab for verifying and uploading real-face assets
방법 2: API(개발자용)
0단계: 자산 라이브러리 키 생성
icover.ai에 로그인한 뒤 설정 → 자산 라이브러리 키 (icover.ai/en/settings/apikeys)로 이동하여 sk-... 형식의 키를 생성합니다.

Settings → Asset Library KEY: click the create button and copy the generated sk-... key (note this is separate from the APIYI Token entry in the sidebar)
1단계: 파일을 업로드하고 public URL을 얻습니다
에셋 파일(이미지이며, 실사 인물 에셋은 동영상 / 오디오도 지원합니다)은 먼저 공개 URL을 통해 접근 가능해야 합니다. 다음 두 경로 중 하나를 선택하십시오. A. 이미 public URL이 있습니다(자체 CDN / 파일 호스트) → 2단계로 건너뜁니다. B. 당사 스토리지에 업로드합니다(두 번의 호출: 서명된 업로드 URL을 요청 → 파일을 PUT):단계 2: 자산을 수집합니다
groupId은 선택 사항입니다. 기본 그룹이 자동으로 사용/생성됩니다. 캐릭터별로 정리하려면: 먼저POST /api/asset-library/groups {"name":"actor-A"}하여 그룹 ID를 가져온 다음, 여기에서"groupId":"group-xxx"를 포함하십시오.label은 선택 사항이며, 웹 UI에서 자산을 식별하는 데 도움이 됩니다.
단계 3: 활성 상태가 될 때까지 폴링합니다
Ingest는 비동기식입니다(이미지당 약 13초, SLA 없음). 반환된 Id로 폴링합니다:Active 없이 90초가 지나면 조사해야 할 타임아웃으로 간주합니다.
4단계: 자산 ID로 동영상 생성(APIYI 사용)
자산 ID를asset://<Id>로 작성하고 자체 APIYI Seedance 동영상 token(자산 라이브러리 키가 아님)을 사용하여 APIYI를 호출합니다.
전체 엔드포인트 참조
- 단일 항목 엔드포인트(그룹 생성 / 수집 / 상태 조회 / 삭제)는 성공과 실패 모두에서 원본 Volcengine JSON을 그대로 전달합니다.
- 목록 엔드포인트(
GETongroups/assets)는 병합되어 내 자산에 맞게 필터링되므로, 상위 원본 출력과 바이트 단위로 동일하지는 않습니다: 원본 Volcengine 필드는 모두 유지되며, 여기에_로 시작하는 몇 가지 자체 메타데이터 필드가 추가됩니다(예:_library). 파싱할 때 알 수 없는_-접두사 필드는 무시하십시오 — 이를 더 추가해도 호환성을 깨는 변경은 아닙니다. - 자체 오류는
[client]가 앞에 붙는 일반 텍스트입니다(400/401/403/404/502). records,real-person/sessions의 GET/PATCH/DELETE, 그리고 자산PATCH는{code, message, data}JSON을 반환합니다(코드 0 = 성공).
실제 인물 자산(완전 자동화된 API)
실제 인물 초상은 촬영 대상자(배우)가 한 번의 생체성 검증을 완료해야 하며, 이를 통해 초상권 소유를 원천에서 확정합니다. 이제 전체 흐름은 완전히 API 기반으로 동작합니다. 웹 UI의 「Real-Person Verification」 탭은 동일한 흐름을 인터페이스로 제공하는 것입니다.Step 1: 검증 세션을 시작하고 H5 링크를 가져옵니다
H5Link를 배우에게 보내 휴대폰에서 열도록 하십시오(또는 QR 코드로 바꿔 스캔하게 하십시오). 배우는 개인 Volcengine 계정에 로그인한 뒤 생체성 검증을 완료합니다. 조명 / 카메라 각도 때문에 시도가 실패할 수 있으며, 이 경우 다시 시도하면 됩니다.BytedToken는 조회용 자격 증명이며, 저희가 세션과 함께 저장합니다.GET /api/asset-library/real-person/sessions를 사용하면 언제든 세션을 조회할 수 있습니다(id / status / h5Link 포함).
Step 2: 배우가 완료한 뒤 결과를 조회합니다
GroupId를 받으면 세션 상태가 authorized로 바뀌고, 실제 인물 자산 그룹은 자동으로 계정에 아카이브됩니다(웹 UI의 자산 그룹에도 표시됩니다). 참고: 검증 대기 상태는 만료된 자격 증명과 동일한 NotFound를 반환합니다. 둘은 구분할 수 없습니다. 오랫동안 사용하지 않은 링크는 만료될 수 있으므로 새 세션을 시작하면 됩니다.
Step 3: 실제 인물 그룹에 자산을 제출합니다
가상 아바타와 동일한 수집 엔드포인트를 사용하며, 실제 인물 그룹의groupId만 전달하면 됩니다. 이미지, 동영상, 오디오를 지원합니다:
Active가 될 때까지 폴링하고 asset://<Id>로 동영상을 생성합니다(4단계는 변경되지 않습니다).
실제 인물 자산 규칙 및 형식:
- 하나의 실제 인물 그룹에는 한 사람만 포함됩니다. 같은 배우가 다른 스타일링을 적용해도 동일한 그룹을 재사용하며, 재검증은 필요하지 않습니다.
- 모든 업로드는 얼굴 일관성 검사를 거칩니다(동영상은 1초마다 샘플링되며, 샘플링된 모든 프레임이 통과해야 합니다). 측면 얼굴, 여러 사람, 흐릿한 자료는 실패하므로 선명한 정면 자료를 사용하십시오.
- 이미지는 30MB 미만입니다. 동영상은 mp4 / mov, 2
15초, ≤50MB, 가로세로 비율 0.42.5입니다. 오디오는 mp3 / wav, 2~15초, ≤15MB입니다.
참고 사항
- 이미지 URL 수명: query / list 엔드포인트가 반환하는 미리보기 URL은 약 12시간 동안만 유효한 임시 주소입니다. 장기 캐시는 하지 마십시오. asset ID 자체는 영구적입니다.
- 요청 제한(Volcengine 계정 수준): status query는 100 QPS, ingest 및 기타 작업은 약 10 QPS입니다. 동시 실행 수를 제어하고 실패 시 재시도하십시오.
- 웹 UI 상태 동기화: API로 ingest한 뒤 status를 한 번도 조회하지 않았다면 웹 아카이브에 “processing”으로 표시될 수 있습니다. asset 목록 페이지를 열고 “Refresh List”를 클릭하여 실제 상태를 동기화하십시오.
volcengine.com/docs/82379/2333565, 실명 자산 온보딩 volcengine.com/docs/82379/2315856.
FAQ
에셋 라이브러리는 참조 이미지를 직접 전달하는 방식과 어떻게 다릅니까?
에셋 라이브러리는 참조 이미지를 직접 전달하는 방식과 어떻게 다릅니까?
asset:// ID를 여러 생성 작업에서 재사용할 수 있으며, 에피소드와 장면 전반에서 캐릭터의 얼굴과 의상을 일관되게 유지할 수 있습니다. 따라서 애니메이션 드라마, 숏 드라마, IP 캐릭터와 같은 연재형 콘텐츠에 적합합니다. 실제 사람도 카메라에 등장할 수 있습니다. 위에 설명된 실제 인물 인증 절차만 완료하면 됩니다.에셋 라이브러리를 사용하는 데 추가 비용이 듭니까? 직접 공식적으로 활성화하는 것과 어떻게 다릅니까?
에셋 라이브러리를 사용하는 데 추가 비용이 듭니까? 직접 공식적으로 활성화하는 것과 어떻게 다릅니까?
에셋 라이브러리는 계정을 따릅니까, 아니면 KEY를 따릅니까? 에셋 격리는 어떻게 구현됩니까?
에셋 라이브러리는 계정을 따릅니까, 아니면 KEY를 따릅니까? 에셋 격리는 어떻게 구현됩니까?
asset:// ID가 유출되면 동일한 채널의 다른 호출자도 생성 요청에서 이를 참조할 수 있습니다. 에셋 ID를 비밀 정보로 취급하십시오.에셋은 APIYI / icover.ai의 자체 서버에 저장됩니까?
에셋은 APIYI / icover.ai의 자체 서버에 저장됩니까?
- 공개 URL(자체 CDN / 이미지 호스트)을 제공하는 경우: 원본 파일은 당사를 거치지 않습니다. 해당 URL만 Volcengine으로 전달합니다.
/api/storage/presign를 통해 업로드하는 경우: 공개 URL을 얻기 위해 파일이 먼저 당사의 오브젝트 스토리지(cdn.icover.ai)에 저장된 후 Volcengine으로 전달됩니다. 해당 원본 파일은 당사의 스토리지에 남아 있습니다.
asset:// ID를 반환합니다. 당사의 데이터베이스에는 해당 ID와 계정 소유권만 저장됩니다(위에서 설명한 계정별 격리에 사용됨). 에셋 콘텐츠 자체는 기록하지 않습니다.실제 얼굴 에셋에는 추가적인 필수 조건이 있습니다. 촬영 대상자는 반드시 대면 실시간 얼굴 인증을 완료해야 합니다(자신의 Volcengine 계정에 로그인하여 얼굴 인식을 수행). 이를 통해 원본 단계에서 초상권 소유를 확인하며, 다른 사람이 대신 인증을 완료할 수 없습니다. 전체 절차는 위의 “실제 얼굴 에셋”을 참조하십시오.회사 내 여러 부서 또는 팀이 에셋 라이브러리를 공유하거나 격리하려면 어떻게 해야 합니까?
회사 내 여러 부서 또는 팀이 에셋 라이브러리를 공유하거나 격리하려면 어떻게 해야 합니까?
asset:// ID를 배포하십시오. 동영상 생성 요청에서 이를 참조하려면 ID를 보유하고 있기만 하면 됩니다(동영상 생성에는 각 부서의 자체 APIYI Seedance 동영상 token이 사용되며, Asset Library KEY와는 관련이 없습니다). 동일한 계정 아래에 여러 KEY를 생성하여 서로 다른 부서에 전달할 수도 있습니다(자격 증명 교체 또는 폐기에 편리함). 이러한 KEY도 동일한 라이브러리에 액세스합니다.부서 간 격리: 각 부서별로 별도의 icover.ai 계정을 등록하고, 각 계정에 고유한 KEY를 생성하십시오. 격리는 나열, 조회, 삭제에 적용된다는 점에 유의하십시오. 유출된 에셋 ID는 여전히 참조할 수 있으므로 부서 간에도 ID를 무분별하게 공유하지 마십시오.이것은 모든 기능을 제공하는 SeeDance 2.0입니까?
이것은 모든 기능을 제공하는 SeeDance 2.0입니까?
doubao-seedance-2-5-260628 및 doubao-seedance-2-0-260128을 실행합니다. 모델 매개변수, 해상도, 길이는 공식 제공 버전과 동일하며, 축소된 기능이 없습니다. 모델 세부 정보와 요금은 Seedance 2.0 / 2.5 개요를 참조하십시오.AI로 생성한 사실적인 초상은 실제 사람으로 간주됩니까? 업로드하면 승인을 의미합니까?
AI로 생성한 사실적인 초상은 실제 사람으로 간주됩니까? 업로드하면 승인을 의미합니까?

Virtual-avatar example: an AI-generated photorealistic portrait with no real-world counterpart. Put the frontal face close-up plus full-body front / side / back views into one asset group for the best character consistency
실사와 같은 디지털 휴먼(가상 아바타)은 검토가 필요합니까?
실사와 같은 디지털 휴먼(가상 아바타)은 검토가 필요합니까?
asset:// ID를 즉시 동영상 생성에 사용할 수 있습니다. 실제 얼굴 에셋만 촬영 대상자의 실시간 인증이 필요합니다(위의 실제 얼굴 섹션 참조).다른 제공업체에서 이미 등록 또는 인증한 에셋을 이전할 수 있습니까?
다른 제공업체에서 이미 등록 또는 인증한 에셋을 이전할 수 있습니까?
asset:// ID는 해당 제공업체의 Volcengine 계정에 속하므로 APIYI 채널을 통해 이를 참조하면 asset not found가 반환됩니다. 에셋을 이 서비스에 다시 등록해야 합니다.- 가상 아바타 에셋: 프로그래밍 방식으로 일괄 이전할 수 있습니다. 이 페이지의 API를 통해 원본 이미지를 다시 업로드하는 스크립트를 작성한 다음, 시스템에서 기존 ID를 새
asset://ID로 업데이트하십시오. 자체 시스템에 에셋 ID 매핑 계층을 유지하는 것을 권장합니다. 비즈니스 데이터에는 내부 ID만 저장하므로, 이후 제공업체를 변경하더라도 매핑만 업데이트하면 됩니다. - 실제 인물 인증 에셋: 실제 인물 인증도 계정에 연결되어 있으며 이전할 수 없고 재인증이 필요합니다. 촬영 대상자가 다시 실시간 인증을 완료해야 합니다(위의 실제 얼굴 섹션 참조).
- 소비자 대상 제품에 대한 조언: 기존 에셋이 많이 있는 경우 백엔드 작업을 통해 가상 에셋을 사용자에게 알리지 않고 이전하십시오. 사용자는 이를 알아차리지 못합니다. 실제 인물 인증 에셋의 경우 시스템 업그레이드나 새 버전 출시 시점에 사용자에게 재인증을 요청하는 방식이 훨씬 자연스럽습니다.