Skip to main content
POST
Upload Assets

Upload Assets

Import assets into the specified asset group. URL is used to pull public HTTPS resources into the asset library (review/transcoding is handled by the server). After the import succeeds, AssetId is returned. In Create Video, it is recommended to reference it as asset://{assetId} instead of repeatedly providing the public URL.

Method and Path

Request Example

Response Example

Asset processing is an asynchronous flow. Use the returned task_id to call Query Asset, and wait until Status becomes Active before using it for video generation.

Authentication

Body

GroupId
string
required
Asset group ID, from the data.Id returned by Create Asset Group.
URL
string
required
Public HTTPS URL of the asset to be imported.
AssetType
string
required
Asset type: Image, Video, Audio.
Name
string
required
Asset name.

Response

state
integer
Business status code.
data.Id
string
Asset ID, which can be written as asset://{Id} during video generation.
data.task_id
string
Import task ID, used for Query Asset.
error
object | null
Error information.