Skip to main content
GET
Seedance 자료 에셋 가져오기
머티리얼 에셋 하나를 조회하고 처리 상태를 확인합니다. 에셋은 ready가 true이고 status가 ACTIVE인 경우에만 비디오 생성에 사용할 수 있습니다. 비디오 생성 시 Seedance material asset not found or not accessible 오류가 반환되면, group_id가 아닌 해당 머티리얼 에셋의 id를 전달했는지 확인하십시오. project_name은 인증된 조직 내 리소스를 분리합니다. 기본값은 default이며 관련 그룹과 소재에는 대소문자를 구분하는 동일한 값을 사용하세요. POST/PUT은 JSON 본문에, GET/DELETE는 쿼리 매개변수에 지정합니다.

요청 예시

응답 예시

인증

Authorization
string
header
필수

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

경로 매개변수

assetId
string
필수

쿼리 매개변수

project_name
string
기본값:default

자료 리소스에 대한 프로젝트 범위.

Required string length: 1 - 128

응답

자료 에셋

id
string
필수

TokenLab 자료 에셋 ID입니다. 에셋이 ACTIVE 상태가 된 후 material_asset_id로 사용하십시오.

object
enum<string>
필수
사용 가능한 옵션:
seedance.material_asset
library_type
enum<string>
필수
사용 가능한 옵션:
aigc_avatar,
liveness_face
asset_type
enum<string>
필수
사용 가능한 옵션:
Image,
Video,
Audio
status
enum<string>
필수
사용 가능한 옵션:
PROCESSING,
ACTIVE,
FAILED,
DELETED
ready
boolean
필수

에셋이 활성 상태이고 삭제되지 않은 경우 true입니다.

group_id
string | null

이 자료 에셋을 소유한 TokenLab 자료 그룹 ID입니다.

project_name
string

이 자료 에셋에 대한 프로젝트 범위입니다.

asset_name
string | null
error_message
string | null

공개 가능한 최종 처리 오류입니다. 영구적인 소스 유효성 검사 실패에는 거부된 크기 제약 조건 등이 포함됩니다.

metadata
object | null
created_at
integer

자료 에셋 레코드가 생성된 Unix 타임스탬프입니다.

updated_at
integer

자료 에셋 레코드가 마지막으로 업데이트된 Unix 타임스탬프입니다.