자산 라이브러리를 사용하는 이유
인물 일관성이 유지되는 동영상을 생성할 때, Seedance 2.0은 사람 얼굴이 포함된 참조 이미지를 직접 허용하지 않습니다(딥페이크 방지 필터링). 먼저 이미지를 신뢰된 자산으로 수집하여asset://xxx 자산 ID를 받은 다음, 동영상 생성 요청에서 해당 ID를 참조해야 합니다.
이 서비스가 수집을 대신 처리해 드립니다. 이미지를 업로드 → asset 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: Asset Library KEY 생성
icover.ai에 로그인한 후 설정 → Asset Library KEY (icover.ai/en/settings/apikeys)로 이동해 sk-... 형식의 KEY를 생성합니다.

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: 파일을 업로드하고 공개 URL을 가져옵니다
에셋 파일(이미지이며, 실인물 에셋은 동영상 / 오디오도 지원함)은 먼저 공개 URL로 접근할 수 있어야 합니다. 다음 경로 중 하나를 선택하십시오. A. 이미 공개 URL이 있습니다(자체 CDN / 파일 호스트) → 단계 2로 건너뜁니다. B. 저희 스토리지에 업로드합니다(두 번 호출: 서명된 업로드 URL 요청 → 파일 PUT):단계 2: 에셋을 등록합니다
groupId은 선택 사항입니다: 기본 그룹이 자동으로 사용/생성됩니다. 캐릭터별로 정리하려면 먼저POST /api/asset-library/groups {"name":"actor-A"}로 그룹 ID를 가져온 다음, 여기에서"groupId":"group-xxx"를 포함합니다.label는 선택 사항이며, 웹 UI에서 에셋을 식별하는 데 도움이 됩니다.
단계 3: Active가 될 때까지 폴링합니다
등록은 비동기식입니다(이미지당 약 13초, SLA 없음). 반환된 Id로 폴링하십시오.Active 없이 90초가 지나면 타임아웃으로 보고 확인하십시오.
단계 4: 에셋 ID로 동영상을 생성합니다(APIYI 경유)
에셋 ID를asset://<Id>로 작성하고, 자체 APIYI SeeDance2 token으로 APIYI를 호출합니다(에셋 라이브러리 KEY가 아닙니다):
전체 엔드포인트 참조
[client] 가 앞에 붙은 일반 텍스트입니다(400/401/403/404/502). records, real-person/sessions의 GET/PATCH/DELETE, 그리고 에셋 PATCH는 {code, message, data} JSON을 반환합니다(code 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.
자주 묻는 질문
자산 라이브러리는 참조 이미지를 직접 전달하는 것과 어떻게 다릅니까?
자산 라이브러리는 참조 이미지를 직접 전달하는 것과 어떻게 다릅니까?
asset:// ID를 여러 생성 작업에서 재사용할 수 있어 에피소드와 샷 전반에서 캐릭터의 얼굴과 의상을 일관되게 유지할 수 있습니다. 애니메이션 드라마, 숏드라마, IP 캐릭터 같은 시리얼 콘텐츠에 이상적입니다. 실제 사람도 카메라에 등장할 수 있으며, 위에 설명한 실물 인물 인증 절차를 완료하기만 하면 됩니다.자산 라이브러리는 계정 기준입니까, KEY 기준입니까? 자산 격리는 어떻게 구현됩니까?
자산 라이브러리는 계정 기준입니까, KEY 기준입니까? 자산 격리는 어떻게 구현됩니까?
asset:// ID가 유출되면 같은 채널의 다른 호출자도 생성 요청에서 이를 참조할 수 있습니다. 자산 ID는 비밀 정보로 취급하십시오.자산은 APIYI / icover.ai 자체 서버에 저장됩니까?
자산은 APIYI / icover.ai 자체 서버에 저장됩니까?
asset:// ID만 반환합니다. 우리는 원본 자산 콘텐츠를 자체적으로 저장하거나 기록하지 않으며, 계정 소유권과 그 ID만 보관합니다(위에서 설명한 계정별 격리에 사용됨).실물 얼굴 자산에는 추가적인 강한 요구사항이 있습니다. 촬영 대상자는 반드시 직접 라이브 얼굴 인증을 완료해야 하며(자신의 Volcengine 계정에 로그인하여 얼굴 인식을 수행), 이를 통해 초상권 소유권이 원천에서 고정됩니다. 다른 누구도 대신 이 인증을 완료할 수 없습니다. 전체 절차는 위의 “실물 얼굴 자산”을 참조하십시오.회사 내 여러 부서 / 팀이 자산 라이브러리를 어떻게 공유하거나 격리합니까?
회사 내 여러 부서 / 팀이 자산 라이브러리를 어떻게 공유하거나 격리합니까?
asset:// ID를 배포하십시오. ID만 보유하면 동영상 생성 요청에서 이를 참조할 수 있습니다(동영상 생성은 각 부서 고유의 APIYI SeeDance2 token을 사용하며, Asset Library KEY와는 무관합니다). 같은 계정 아래에 여러 KEY를 만들어 각 부서에 나눠줄 수도 있습니다(자격 증명 교체 / 폐기에 편리함). 이 KEY들도 여전히 같은 라이브러리에 접근합니다.부서 간 격리: 부서마다 별도의 icover.ai 계정을 등록하고, 각 계정에 자기 KEY를 부여하십시오. 격리는 나열 / 조회 / 삭제에만 적용된다는 점에 유의하십시오. 유출된 자산 ID는 여전히 참조될 수 있으므로, 부서 간이라도 ID를 무분별하게 배포하지 마십시오.이것은 풀 기능 SeeDance 2.0입니까?
이것은 풀 기능 SeeDance 2.0입니까?
doubao-seedance-2-0-260128를 실행하며, 모델 파라미터, 해상도, 지속 시간은 공식 제공과 동일하고 축소된 부분이 없습니다. 모델 세부 정보와 요금은 Seedance 2.0 개요를 참조하십시오.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만 저장하므로, 나중에 제공업체를 바꿔도 매핑만 업데이트하면 됩니다. - 실물 인물 인증 자산: 실물 인물 인증 역시 계정에 종속되며 이전할 수 없습니다. 재인증이 필요합니다. 촬영 대상자는 생체 검증을 다시 완료해야 합니다(위의 실물 얼굴 섹션을 참조하십시오).
- 소비자 대상 제품에 대한 조언: 기존 자산이 많다면 백엔드 작업으로 가상 자산을 조용히 이전하십시오. 사용자는 알아차리지 못합니다. 실물 인물 인증 대상은 시스템 업그레이드나 새 버전 출시 시점에 사용자에게 재인증을 요청하는 것이 훨씬 자연스럽습니다.