Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Bearer token authentication. Format Bearer <token> where <token> is your API Key.

Body

model
enum<string>
required

Use volc-asset-video. For specific content requests, select volc-asset-video-nsfw under the Direct resource group.

Available options:
volc-asset-video,
volc-asset-video-nsfw
Example:

"volc-asset-video"

GroupId
string
required

Asset group ID.

Example:

"group-20260319072926-rrnmg"

AssetType
enum<string>
required

Asset type. Fixed value Video. Supported formats: MP4 and MOV. Resolution: 480p, 720p, 1080p, or 4K. Duration: 2–30 seconds. Aspect ratio: 0.4–2.5. Width and height: 300–6000 px. Total pixels: 407696–2086876. File size: no more than 200 MB. Frame rate: 24–60 FPS. All constraints apply together.

Available options:
Video
Example:

"Video"

URL
string
required

Publicly accessible video URL. Base64 video input is not supported. The referenced file must satisfy the Video limits listed under AssetType.

Example:

"https://example.com/video.mp4"

Name
string

Asset name, up to 64 characters. Used only for fuzzy search in ListAssets and not passed to model inference.

Maximum string length: 64
Example:

"scene-clip"

ProjectName
string
default:default

Project that owns the asset. Must match the ProjectName of the target asset group; omit it for the default project.

Example:

"default"

Response

The video was accepted for asynchronous processing. Poll GetAsset until Status becomes Active or Failed; upload-time SLA is not guaranteed. Video activation is typically 9–12 seconds in ideal conditions and may take about 10 seconds to 2 minutes when the review queue is congested.

Id
string

Asset ID. After Status becomes Active, use asset://<ID> in Seedance requests instead of the temporary GetAsset URL.

Example:

"asset-20260320120147-pqwhc"