Skip to main content
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

​
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
​
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
​
string
A descriptive name for the asset to help you identify and manage it in the library.Example: My portrait photo

​
Response Fields

​
integer
Response status code. 0 indicates success; any other value indicates failure.
​
string
Response message. Returns null on success, or an error description on failure.
​
object
The response data object, returned on success.

​
Asset Types and Requirements

​
Example Request

Success response:
Once you have the assetId, reference the asset in a generation task using the asset:// prefix:
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.