Seedance 2.0: Upload an Asset to the Media Library

Upload an image, video, audio, or document asset to the Seedance 2.0 library and receive an assetId to reference in generation tasks.

Use this endpoint to upload media assets (images, videos, audio, or documents) to the Seedance 2.0 asset library. After upload, reference the asset in generation task parameters using the asset://{assetId} format instead of a raw public URL.

Base URL: https://zcbservice.aizfw.cn/kyyReactApiServer

Endpoint: POST /kyyVideo2/asset/upload

When to Use This Endpoint

Upload assets to the Seedance 2.0 library when:

• You have face images that require moderation review before use in generation tasks.
• You want to reuse the same media across multiple generation tasks without re-supplying a URL each time.
• Your media URLs are not publicly accessible and cannot be referenced directly by the API.

---

Request Parameters

assetType · string · required

The type of asset being uploaded. Must be one of the following exact values (case-sensitive, first letter uppercase):

• Image — image files
• Video — video files
• Audio — audio files
• Document — document files

url · string · required

The publicly accessible URL of the asset to upload. The API must be able to fetch this URL at the time of the request.

Example: https://example.com/portrait.jpg

name · string

A descriptive name for the asset to help you identify and manage it in the library.

Example: My portrait photo

---

Response Fields

code · integer

Response status code. 0 indicates success; any other value indicates failure.

msg · string

Response message. Returns null on success, or an error description on failure.

data · object

The response data object, returned on success.

Show data object properties

data.assetId · string

The assigned asset ID, in the format asset-{timestamp}-{random}. Use this value as asset://{assetId} when referencing the asset in generation task parameters.

Example: asset-20260330142158-q75m8

---

Asset Types and Requirements

Type	Supported Formats	Use In
Image	jpeg, png, webp, bmp, tiff, gif	referenceImages, first_image, last_image
Video	480p, 720p	referenceVideos
Audio	wav, mp3	referenceAudios
Document	document files	—

---

Example Request

curl -X POST https://zcbservice.aizfw.cn/kyyReactApiServer/kyyVideo2/asset/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assetType": "Image",
    "url": "https://example.com/portrait.jpg",
    "name": "My portrait photo"
  }'

Success response:

{
  "code": 0,
  "msg": null,
  "data": {
    "assetId": "asset-20260330142158-q75m8"
  }
}

Once you have the assetId, reference the asset in a generation task using the asset:// prefix:

{
  "first_image": "asset://asset-20260330142158-q75m8"
}

After uploading an asset, check its status using the Asset Details endpoint before using it in a generation task. Assets are not always immediately available.

Assets that contain faces are subject to moderation review before they can be used. Wait until the asset status is Active before referencing it in a generation task.