Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xingchaoyiqing.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
Asset Types and Requirements

TypeSupported FormatsUse In
Imagejpeg, png, webp, bmp, tiff, gifreferenceImages, first_image, last_image
Video480p, 720preferenceVideos
Audiowav, mp3referenceAudios
Documentdocument 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.