비디오 및 자료
Material Asset 가져오기
TokenLab material asset ID를 사용하여 Seedance material asset 하나를 가져옵니다.
하나의 material asset을 가져와 처리 상태(PROCESSING, ACTIVE, FAILED 또는 DELETED)를 확인합니다. 해당 asset은 ready가 true이고 status가 ACTIVE일 때만 비디오 생성에 사용할 수 있습니다. 처리가 실패하면 error_message에 그 이유가 표시됩니다.
비디오 생성 시 Seedance material asset not found or not accessible 오류가 반환되면, material group_id가 아닌 이 material asset id를 전달했는지 확인하십시오.
project_name은 조직 내 리소스 범위를 지정하며 기본값은 default입니다. 관련 그룹 및 asset에는 대소문자를 구분하는 동일한 값을 사용하십시오. POST/PUT 요청 시에는 JSON 본문에, GET/DELETE 요청 시에는 쿼리 문자열에 포함하여 전송합니다.
요청 예시
curl "https://api.tokenlab.sh/v1/videos/assets/asset-20260720123456-qn7wr?project_name=default" \
-H "Authorization: Bearer $TOKENLAB_API_KEY"응답 예시
{
"id": "asset-20260720123456-qn7wr",
"object": "seedance.material_asset",
"project_name": "default",
"group_id": "group-20260720123456-vrt01",
"library_type": "aigc_avatar",
"asset_name": "Front view",
"asset_type": "Image",
"status": "ACTIVE",
"ready": true,
"error_message": null,
"metadata": null,
"created_at": 1782998400000,
"updated_at": 1782998400000
}curl -X GET "https://example.com/v1/videos/assets/asset-20260720123456-qn7wr"{ "id": "asset-20260720123456-qn7wr", "object": "seedance.material_asset", "group_id": "group-20260720123456-vrt01", "library_type": "aigc_avatar", "asset_name": "Front view", "asset_type": "Image", "status": "ACTIVE", "ready": true, "error_message": null, "metadata": null, "created_at": 1782998400000}인증
BearerAuth AuthorizationBearer <token>
API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
경로 매개변수
assetId*string
쿼리 매개변수
project_name?string
자료 리소스에 대한 프로젝트 범위.
길이
1 <= length <= 128기본값
"default"응답
application/json
application/json
application/json
application/json
application/json