Skip to main content
icover.ai는 APIYI의 하위 제품으로, AI 동영상 생성을 테스트하는 온라인 도구입니다. 이 자산 라이브러리와 API는 개발자와 고객이 “캐릭터 일관성 동영상” 기능을 제공하는 데 도움이 됩니다.

자산 라이브러리를 사용하는 이유

인물 일관성이 유지되는 동영상을 생성할 때, Seedance 2.0은 사람 얼굴이 포함된 참조 이미지를 직접 허용하지 않습니다(딥페이크 방지 필터링). 먼저 이미지를 신뢰된 자산으로 수집하여 asset://xxx 자산 ID를 받은 다음, 동영상 생성 요청에서 해당 ID를 참조해야 합니다. 이 서비스가 수집을 대신 처리해 드립니다. 이미지를 업로드 → asset ID 받기 → 동영상 생성만 하시면 됩니다. 사용하는 방법은 두 가지이며, 데이터는 두 방식 간에 완전히 공유됩니다:
공유 데이터: 같은 계정에서는 웹과 API를 통해 업로드한 자산이 모두 동일한 라이브러리에 저장됩니다. 즉, API로 생성한 자산은 웹 자산 목록 / 아카이브와 동영상 생성기의 참조 이미지 선택기에 표시되며, 웹에서 생성한 자산도 API를 통해 조회할 수 있습니다.자산 라이브러리는 KEY가 아니라 icover.ai 계정을 따릅니다: 동일한 계정 아래 생성된 모든 Asset Library KEY는 서로 동등하며 같은 라이브러리에 접근합니다. KEY는 단순한 호출 자격 증명일 뿐이며 격리를 제공하지 않습니다. 자산은 계정별로 격리되며, 본인 것만 보고 조작할 수 있습니다. 격리와 여러 팀의 공유 옵션은 아래 FAQ를 참조하십시오.
서로 다른 두 KEY입니다. 혼동하지 마십시오:
  • Asset Library KEY (icover.ai에서 생성, sk-...): 이 페이지의 자산 라이브러리 엔드포인트만 사용합니다(업로드 / 수집 / 조회 / 삭제).
  • APIYI SeeDance2 token (api.apiyi.com에서 생성, sk-..., SeeDance2 그룹이 활성화된 상태): 동영상 생성 엔드포인트에만 사용합니다.

방법 1: 웹 UI(초보자에게 권장)

1

가입 및 로그인

icover.ai 자산 라이브러리 페이지를 열어 가입하고 로그인합니다.
2

업로드 및 수집

“Virtual Avatar Ingest” 탭에서 이미지를 선택합니다(다중 선택 지원) → “Upload & Ingest”를 클릭합니다.
  • 자산 그룹은 선택 사항입니다. 시스템이 기본 그룹을 자동으로 사용합니다. 캐릭터별로 자산을 정리하려면 먼저 그룹을 만드십시오.
  • 이미지 요구사항: jpeg / png / webp / bmp / tiff / gif / heic; 종횡비 0.4–2.5; 변 길이 300–6000px; 각 파일 30MB 미만입니다.
3

자산 ID 복사

약 10초 이상 기다리십시오. 상태가 “Active”로 바뀌면 asset://xxx 자산 ID를 복사합니다.
4

동영상 생성

icover.ai 동영상 생성기로 이동합니다: “Multimodal” 모드로 전환하고, 참조 이미지 유형을 “Asset”으로 설정한 뒤, 자산을 선택하고 prompt에서는 캐릭터를 “Image 1”로 참조합니다.
실인물 자산(웹 버전): “Real-Person Verification” 탭에서 3단계로 진행합니다 — 1) “Generate verification link”를 클릭한 다음 배우가 QR 코드를 스캔하거나 휴대폰으로 링크를 열고 Volcengine 계정에 로그인하여 실재성 검증을 완료합니다. 2) “Query verification result”를 클릭해 배우 전용 실인물 자산 그룹을 받습니다. 3) 해당 그룹을 선택하고 자산(이미지 / 동영상 / 오디오)을 업로드하면 얼굴 일관성 검사를 통과하며 asset:// ID를 얻습니다. 같은 배우라도 스타일이 달라져도 같은 그룹을 재사용하므로 재검증이 필요하지 않습니다.
SeeDance 2.0 자산 라이브러리 웹 UI: Active 상태 배지가 있는 자산 카드, 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를 생성합니다.
icover.ai 설정의 Asset Library 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로 폴링하십시오.
3초마다 폴링하는 것을 권장합니다. Active 없이 90초가 지나면 타임아웃으로 보고 확인하십시오.

단계 4: 에셋 ID로 동영상을 생성합니다(APIYI 경유)

에셋 ID를 asset://<Id>로 작성하고, 자체 APIYI SeeDance2 token으로 APIYI를 호출합니다(에셋 라이브러리 KEY가 아닙니다):
프롬프트에서는 에셋을 “이미지 1”로 지칭하십시오 — 프롬프트에 원본 에셋 ID를 직접 쓰지 마십시오.
모델 선택, 과금 및 해상도 표는 Seedance 2.0 개요를 참조하십시오. 전체 생성 파라미터는 Video Generation API를 참조하십시오. 전체 실행 가능 엔드 투 엔드 스크립트(업로드 → 수집 → 생성 → 다운로드)는 Asset Reference Guide를 참조하십시오.

전체 엔드포인트 참조

응답 규칙: asset-library 엔드포인트는 성공과 실패 모두에서 원시 Volcengine JSON을 그대로 반환합니다(목록은 본인 에셋만 필터링됩니다). 자체 오류는 [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, 215초, ≤50MB, 가로세로 비율 0.42.5입니다. 오디오는 mp3 / wav, 2~15초, ≤15MB입니다.

참고 사항

asset:// ID는 비밀로 취급하십시오: asset은 이 서비스 계층에서 분리되어 있으며(목록 조회와 삭제로부터 보호됨), Volcengine은 ID로 권한을 부여할 수 없습니다. 따라서 ID가 유출되면 동일한 채널의 다른 호출자가 생성 요청에서 이를 참조할 수 있습니다. 전체 소유 및 격리 모델은 아래의 FAQ를 참조하십시오.
  • 이미지 URL 수명: query / list 엔드포인트가 반환하는 미리보기 URL은 약 12시간 동안만 유효한 임시 주소입니다. 장기 캐시는 하지 마십시오. asset ID 자체는 영구적입니다.
  • 요청 제한(Volcengine 계정 수준): status query는 100 QPS, ingest 및 기타 작업은 약 10 QPS입니다. 동시 실행 수를 제어하고 실패 시 재시도하십시오.
  • 웹 UI 상태 동기화: API로 ingest한 뒤 status를 한 번도 조회하지 않았다면 웹 아카이브에 “processing”으로 표시될 수 있습니다. asset 목록 페이지를 열고 “Refresh List”를 클릭하여 실제 상태를 동기화하십시오.
Volcengine 공식 참고 자료(브라우저에 복사하여 열기): 비공개 asset 라이브러리 가이드 volcengine.com/docs/82379/2333565, 실명 자산 온보딩 volcengine.com/docs/82379/2315856.

자주 묻는 질문

직접 참조 이미지는 사실적인 인물 얼굴을 포함할 수 없습니다(딥페이크 방지 필터가 이를 거부합니다). 초상화가 신뢰할 수 있는 자산으로 한 번 등록되면, 해당 asset:// ID를 여러 생성 작업에서 재사용할 수 있어 에피소드와 샷 전반에서 캐릭터의 얼굴과 의상을 일관되게 유지할 수 있습니다. 애니메이션 드라마, 숏드라마, IP 캐릭터 같은 시리얼 콘텐츠에 이상적입니다. 실제 사람도 카메라에 등장할 수 있으며, 위에 설명한 실물 인물 인증 절차를 완료하기만 하면 됩니다.
한 줄로 말하면: icover.ai는 자산을 격리하고, APIYI는 통합 호출을 처리합니다. 생성 측에서는 자산 ID만 확인하며, ID를 보유하고 있으면 참조할 수 있습니다.이는 계정을 따릅니다. 기본 아키텍처는 다음과 같습니다. 모든 icover.ai 사용자는 단일 통합 APIYI Volcengine 계정을 공유하며, 자산 라이브러리는 그 계정에 속합니다. icover.ai는 서비스 수준에서 계정별 격리를 한 겹 더 추가하여, 각 계정은 자기 자산만 나열 / 조회 / 삭제할 수 있고 다른 사람의 자산 ID는 볼 수 없습니다.KEY는 격리를 제공하지 않습니다. 같은 계정 아래의 여러 Asset Library KEY는 서로 동일하며 같은 라이브러리에 접근합니다. 자산 격리가 필요하다면(예: 고객사 또는 사업부별로 데이터를 분리하려는 경우), 각 당사자마다 별도의 icover.ai 계정을 등록하고 각 계정 아래에서 KEY를 생성하십시오. 같은 계정 아래에서 새 KEY를 만든다고 해서 아무것도 격리되지 않습니다.보안 경계에 유의하십시오. 이 격리는 나열 / 조회 / 삭제에만 적용되며, Volcengine은 ID로 권한을 부여할 수 없습니다. 한 번 asset:// ID가 유출되면 같은 채널의 다른 호출자도 생성 요청에서 이를 참조할 수 있습니다. 자산 ID는 비밀 정보로 취급하십시오.
아닙니다. 웹 UI를 통해서든 API를 통해서든, 자산 라이브러리는 본질적으로 모든 것을 Volcengine의 공식 자산 라이브러리 엔드포인트로 전달합니다. 이미지 / 동영상 / 오디오 콘텐츠는 처리 목적으로 곧바로 Volcengine으로 전송되며, Volcengine은 asset:// ID만 반환합니다. 우리는 원본 자산 콘텐츠를 자체적으로 저장하거나 기록하지 않으며, 계정 소유권과 그 ID만 보관합니다(위에서 설명한 계정별 격리에 사용됨).실물 얼굴 자산에는 추가적인 강한 요구사항이 있습니다. 촬영 대상자는 반드시 직접 라이브 얼굴 인증을 완료해야 하며(자신의 Volcengine 계정에 로그인하여 얼굴 인식을 수행), 이를 통해 초상권 소유권이 원천에서 고정됩니다. 다른 누구도 대신 이 인증을 완료할 수 없습니다. 전체 절차는 위의 “실물 얼굴 자산”을 참조하십시오.
하나의 라이브러리를 공유하는 방식(권장, 가장 간단함): 하나의 계정 + 하나의 KEY면 충분합니다. 자산 ID는 자체 시스템에서 중앙 관리하고 각 부서에 asset:// ID를 배포하십시오. ID만 보유하면 동영상 생성 요청에서 이를 참조할 수 있습니다(동영상 생성은 각 부서 고유의 APIYI SeeDance2 token을 사용하며, Asset Library KEY와는 무관합니다). 같은 계정 아래에 여러 KEY를 만들어 각 부서에 나눠줄 수도 있습니다(자격 증명 교체 / 폐기에 편리함). 이 KEY들도 여전히 같은 라이브러리에 접근합니다.부서 간 격리: 부서마다 별도의 icover.ai 계정을 등록하고, 각 계정에 자기 KEY를 부여하십시오. 격리는 나열 / 조회 / 삭제에만 적용된다는 점에 유의하십시오. 유출된 자산 ID는 여전히 참조될 수 있으므로, 부서 간이라도 ID를 무분별하게 배포하지 마십시오.
예. APIYI의 SeeDance2 채널은 공식 풀 기능 doubao-seedance-2-0-260128를 실행하며, 모델 파라미터, 해상도, 지속 시간은 공식 제공과 동일하고 축소된 부분이 없습니다. 모델 세부 정보와 요금은 Seedance 2.0 개요를 참조하십시오.
아닙니다, 실물 인물로 간주되지 않습니다. 실제 세계에 대응되는 인물이 없는 AI 생성 사실적 초상(예: Nano Banana 같은 모델로 생성한 캐릭터)은 가상 아바타이며, 권한 부여 단계 없이 바로 가상 아바타 인제스트 흐름으로 들어갑니다. 실제로 존재하는 사람의 사진만 실물 얼굴로 간주됩니다. 그런 경우 업로드가 권한 부여를 의미하지는 않습니다. 가상 아바타 인제스트 채널은 이를 거부하며, 촬영 대상자는 생체 검증을 완료해야 합니다(위의 실물 얼굴 섹션을 참조하십시오).캐릭터 소재의 세 가지 유형:
같은 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

아닙니다. 가상 아바타 인제스트는 완전 자동입니다. 수동 심사도, 권한 부여 단계도 없습니다. 업로드 후 시스템이 이미지를 자동으로 전처리하며, 약 13초 뒤 상태가 Active로 바뀌고 asset:// ID를 곧바로 동영상 생성에 사용할 수 있습니다. 실물 얼굴 자산만 촬영 대상자가 생체 검증을 완료해야 합니다(위의 실물 얼굴 섹션을 참조하십시오).
직접 재사용할 수는 없습니다. Volcengine 자산 라이브러리와 실물 인물 인증은 모두 기반 계정에 종속됩니다. 다른 제공업체를 통해 얻은 asset:// ID는 그 제공업체의 Volcengine 계정에 속하며, APIYI 채널을 통해 이를 참조하면 asset not found가 반환됩니다. 자산은 이 서비스로 다시 인제스트해야 합니다.
  • 가상 아바타 자산: 이는 대량으로 프로그램 방식 이전이 가능합니다. 원본 이미지를 이 페이지의 API를 통해 다시 업로드하는 스크립트를 작성한 다음, 시스템의 기존 ID를 새 asset:// ID로 갱신하십시오. 자체 시스템에 자산 ID 매핑 계층을 두는 것을 권장합니다. 비즈니스 데이터는 내부 ID만 저장하므로, 나중에 제공업체를 바꿔도 매핑만 업데이트하면 됩니다.
  • 실물 인물 인증 자산: 실물 인물 인증 역시 계정에 종속되며 이전할 수 없습니다. 재인증이 필요합니다. 촬영 대상자는 생체 검증을 다시 완료해야 합니다(위의 실물 얼굴 섹션을 참조하십시오).
  • 소비자 대상 제품에 대한 조언: 기존 자산이 많다면 백엔드 작업으로 가상 자산을 조용히 이전하십시오. 사용자는 알아차리지 못합니다. 실물 인물 인증 대상은 시스템 업그레이드나 새 버전 출시 시점에 사용자에게 재인증을 요청하는 것이 훨씬 자연스럽습니다.

문의하기

연동 중 문제가 발생하면(ingest 실패, 실인증, 배치 연동, 운영 token 신청 등) 언제든지 문의해 주십시오. 연락처는 api.apiyi.com 홈페이지에 있습니다.