v1

latestOpenAPI 3.1.02026-07-224941145.6 KB

Create Video Asset

Upload a video to an existing asset group. The returned Asset ID can be referenced as asset://<ID> in Seedance 2.0 requests for video reference, extension, and similar scenarios. Supports mp4/mov format, ≤50 MB, 2–15 seconds. Video asset activation is typically 9–12 seconds in ideal conditions. Actual timing may vary with file size and review queue load; during congestion, activation may take about 10 seconds to 2 minutes. CreateAsset is asynchronous; system processing may queue the asset, and upload-time SLA is not guaranteed. Poll GetAsset after creation and use the asset only after Status becomes Active; Failed means preprocessing failed and the asset cannot be used. In generation requests, reference the asset as asset://<ID> instead of using the temporary GetAsset URL.

post/volc/asset/CreateAsset

Request body

model'volc-asset-video'

Billing model. Fixed value volc-asset-video for videos.

GroupIdstring required

Asset group ID.

Namestring

Asset name.

AssetType'Video' required

Asset type. Fixed value Video for videos.

URLstring required

Video URL (mp4/mov, ≤50 MB, 2–15 seconds).

Example request

{
  "model": "volc-asset-video",
  "GroupId": "group-20260319072926-rrnmg",
  "Name": "scene-clip",
  "AssetType": "Video",
  "URL": "https://example.com/video.mp4"
}

Response

Video asset created successfully

Idstring

Asset ID. Use as asset://<ID> in Seedance 2.0 requests.

Example response

{
  "Id": "asset-20260320120147-pqwhc"
}