Video

Create Seedance material asset

Uploads one Seedance material asset URL into a TokenLab material group. Image materials must use supported dimensions; an invalid source is rejected with 400 seedance_material_source_invalid instead of remaining in PROCESSING. Real-person assets require the group_id mapped from Result.GroupId returned by GetVisualValidateResult.

post/v1/videos/assets

Request

  • Base URL: https://api.tokenlab.sh
  • URL: https://api.tokenlab.sh/v1/videos/assets
  • Auth: HTTP bearer

Request body

asset_urlstring uri required

Publicly reachable source URL to import. TokenLab stores the material for later use; do not rely on this URL as the long-term material address.

asset_namestring

Optional display name stored with the material asset.

asset_type'Image' | 'Video' | 'Audio'
library_type'aigc_avatar' | 'liveness_face'

Material library class. aigc_avatar is for virtual-avatar materials. liveness_face is for verified real-person materials.

group_idstring

TokenLab material group ID. Required for liveness_face materials; optional for aigc_avatar.

project_namestring

Project scope for the material asset. Assets and groups are isolated by project inside the authenticated organization.

metadataobject nullable

Optional client metadata stored with the material asset.

Response

Material asset created

idstring required

TokenLab material asset ID. Use this as material_asset_id after the asset becomes ACTIVE.

object'seedance.material_asset' required
group_idstring nullable

TokenLab material group ID that owns this material asset.

project_namestring

Project scope for this material asset.

library_type'aigc_avatar' | 'liveness_face' required
asset_namestring nullable
asset_type'Image' | 'Video' | 'Audio' required
status'PROCESSING' | 'ACTIVE' | 'FAILED' | 'DELETED' required
readyboolean required

True when the asset is active and not deleted.

error_messagestring nullable

Public-safe terminal processing error. Permanent source validation failures include the rejected dimension constraint.

metadataobject nullable
created_atinteger

Unix timestamp when the material asset record was created.

updated_atinteger

Unix timestamp when the material asset record was last updated.

Changes

No recorded changes to this operation across all 1 revision of this API.