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

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

Response

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