비디오 및 자료
Material Asset 생성
Seedance material asset을 TokenLab material 그룹에 업로드합니다.
공개적으로 접근 가능한 소스 URL을 Seedance material 그룹으로 가져옵니다. TokenLab은 나중에 사용할 수 있도록 material을 저장합니다. 생성 시에는 소스 URL이 아닌 반환된 material asset id를 사용하십시오.
library_type: "aigc_avatar"의 경우 group_id는 선택 사항입니다. group_id가 없으면 TokenLab은 조직의 기본 가상 아바타 그룹을 사용하거나 생성합니다. library_type: "liveness_face"의 경우 group_id는 필수이며, 시각 인증 결과 조회에서 반환된 TokenLab 그룹이어야 합니다. project_name이 default가 아닌 경우에도 group_id가 필요합니다. 그룹은 동일한 project_name 및 library_type에 속해야 하며, 그렇지 않으면 요청 시 400 오류가 반환됩니다.
| 유형 | 지원되는 입력 |
|---|---|
| 이미지 | jpeg, jpg, png, webp, bmp, tiff, gif, heic, heif; ≤30 MiB; 가로 및 세로 [300, 6000] px; 종횡비 [0.4, 2.5]. |
| 비디오 | mp4, mov; ≤200 MiB. |
| 오디오 | aac, wav, mp3; ≤15 MiB. |
TokenLab은 요청을 수락하기 전에 소스 URL, 미디어 유형, 파일 크기 및 이미지를 읽을 수 있는 경우 해당 치수를 확인합니다. 이러한 검사를 통과하지 못한 소스는 seedance_material_source_* 코드와 함께 400 오류를 반환합니다. 예를 들어 seedance_material_source_invalid(이미지 치수 또는 종횡비 범위를 벗어남), seedance_material_source_type_mismatch, seedance_material_source_too_large 또는 seedance_material_source_url_unreachable 등이 있습니다. 기타 미디어 및 얼굴 요구 사항은 처리 중에 평가되므로, 수락되었다고 해서 asset이 바로 준비된 것은 아닙니다. ACTIVE 상태가 될 때까지 기다리고, 처리에 실패할 경우 error_message를 확인하십시오.
성공적인 요청은 status: "PROCESSING"과 함께 201을 반환합니다. status가 ACTIVE가 될 때까지 머티리얼 에셋 가져오기을 폴링하십시오. 실제 사람 그룹의 경우, 하나의 그룹은 한 명의 검증된 사람과 매핑됩니다. 여러 얼굴이 포함되어 있거나 검증된 사람과 일치하지 않는 얼굴이 포함된 업로드는 실패할 수 있습니다.
project_name은 조직 내 리소스 범위를 지정하며 기본값은 default입니다. 관련 그룹 및 asset에는 대소문자를 구분하여 동일한 값을 사용하십시오. POST/PUT 요청 시에는 JSON 본문에, GET/DELETE 요청 시에는 쿼리 문자열에 포함하여 전송하십시오.
요청 예시
curl https://api.tokenlab.sh/v1/videos/assets \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"library_type":"aigc_avatar","group_id":"group-20260720123456-vrt01","asset_url":"https://example.com/reference.png","asset_type":"Image","asset_name":"Front view","project_name":"default"}'응답 예시
{
"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": "PROCESSING",
"ready": false,
"error_message": null,
"metadata": null,
"created_at": 1782998400000,
"updated_at": 1782998400000
}curl -X POST "https://example.com/v1/videos/assets" \ -H "Content-Type: application/json" \ -d '{ "asset_url": "https://example.com/reference.png", "asset_name": "Front view", "asset_type": "Image", "library_type": "aigc_avatar", "group_id": "group-20260720123456-vrt01" }'{ "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": "PROCESSING", "ready": false, "error_message": null, "metadata": null, "created_at": 1782998400000}인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
요청 본문
application/json
응답
application/json
application/json
application/json
application/json
application/json
application/json