Upload Assets

Use `POST /v1/seedance/asset/CreateAsset` to import public assets into the Seedance asset library.

POSThttps://zx1.deepwl.net/v1/seedance/asset/CreateAsset

Request

curl -X POST https://zx1.deepwl.net/v1/seedance/asset/CreateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '
{
  "GroupId": "group-xxx",
  "URL": "https://example.com/reference.webp",
  "AssetType": "Image",
  "Name": "child"
}'

Response

{
  "state": 1,
  "data": {
    "Id": "asset-xxx",
    "task_id": "task_xxx"
  },
  "error": null
}

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.

Request Headers

Authorizationstring必填

Authentication header. Uses a Bearer token, e.g. Bearer YOUR_API_KEY.

Content-Typestring必填

Request content type, must be application/json.

Request Body

GroupIdstring必填

Asset group ID, from the data.Id returned by Create Asset Group.

URLstring必填

Public HTTPS URL of the asset to be imported.

AssetTypestring必填

Asset type: Image, Video, Audio.

Namestring必填

Asset name.

Request Examples

Response Examples

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.

Response Fields

stateinteger

Business status code.

dataobject

Business data.

Idstring

Asset ID, which can be written as asset://{Id} during video generation.

task_idstring

Import task ID, used for Query Asset.

errorobject | null

Error information.