Seedance 디지털 휴먼 자료 라이브러리

네이티브 Action API로 Seedance 디지털 휴먼 자료 생성, 확인, 업로드 및 참조를 수행합니다.

Seedance 디지털 휴먼 자료 라이브러리는 Seedance 2.0과 Seedance 2.5에서 참조할 수 있는 실제 인물 및 가상 캐릭터 자료를 관리합니다. 네이티브 API는 Action, Version 및 해당 요청·응답 구조를 유지하며 AGTCloud API 키로 호출합니다.

자료 유형 선택

자료 유형	생성 방법	적합한 용도	주요 제한
가상 캐릭터(AIGC)	자료 컨테이너를 직접 생성한 후 업로드	가상 진행자, 캐릭터 및 제품 자료	서버에서 업로드 주소에 접근할 수 있어야 합니다
실제 인물(LivenessFace)	먼저 얼굴 라이브니스 확인 완료	실제 인물 디지털 휴먼 및 본인 이미지	자료가 확인된 얼굴과 일치해야 합니다

가상 캐릭터 연동 절차

자료 컨테이너 생성

CreateAssetGroup을 호출하여 AIGC 자료 그룹을 생성하고 반환된 자료 그룹 ID를 저장합니다.

자료 업로드

공개적으로 접근 가능한 이미지, 비디오 또는 오디오를 자료 그룹에 업로드합니다. 업로드 성공은 요청이 접수되었다는 의미일 뿐이며 자료는 일반적으로 먼저 처리 중 상태가 됩니다.

자료 사용 가능 상태 대기

상태가 Active가 될 때까지 자료 조회 API를 폴링합니다. Failed 상태가 되면 오류 정보를 읽고 해당 자료를 계속 사용하지 마세요.

비디오 작업에서 참조

Seedance 네이티브 생성 요청의 자료 URL로 asset://자료ID 또는 asset://자료그룹ID를 사용합니다. 참조하는 자료는 현재 계정에 속하고 사용 가능한 상태여야 합니다.

실제 인물 연동 절차

실제 인물의 경우 먼저 확인 세션을 생성하고 사용자가 휴대전화 브라우저에서 라이브니스 촬영을 완료하도록 안내한 뒤 GetVisualValidateResult를 호출하여 실제 인물 자료 그룹 ID를 가져와야 합니다. 세션이 만료되면 다시 생성해야 합니다.

실제 인물 자료 그룹을 가져온 뒤 자료를 계속 업로드할 수 있지만 얼굴은 확인된 인물과 일치해야 합니다. 일치하지 않는 자료는 실패 상태가 되며 FaceMismatch를 반환합니다.

자료 상태 및 결과

Processing: 자료를 처리 중입니다. 약 3초 간격으로 조회하고 쉬지 않고 연속 폴링하지 마세요.
Active: 자료를 비디오 생성에 사용할 수 있습니다.
Failed: 오류 원인을 읽고 폴링을 중단합니다. 자료를 수정한 뒤 다시 업로드합니다.
GetAsset이 반환하는 서명된 URL의 유효 기간은 약 11.5시간이며 영구 주소로 저장하거나 공개 배포해서는 안 됩니다.

자료는 API 키가 속한 계정에 연결됩니다. 존재하지 않거나 현재 계정에 속하지 않는 자료에 접근하면 ResourceNotFound를 반환할 수 있습니다. 자료 그룹 삭제 시 그룹 내 자료도 함께 삭제되므로 작업 전에 대상 ID와 삭제 범위를 확인해야 합니다.