GlobalAiOpcGlobalAiOpc
wechatwechat
GlobalAiOpc

Upload Asset

Upload images, videos, audio and other assets to Seedance2.0 asset library

POST/kyyReactApiServer/kyyVideo2/asset/upload

Seedance2.0 Upload Asset

Upload assets to the Seedance2.0 asset library and obtain asset IDs for use in video generation tasks.

Authentication

Get Key
All requests require a Bearer token in the request header:
cURL
Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Request Parameters

assetTypestringrequired
Asset type, first letter must be capitalized
Available options:
  • Image - Image
  • Video - Video
  • Audio - Audio
  • Document - Document
First letter must be capitalized
urlstringrequired
Public URL of the asset
Example: https://example.com/image.jpg
namestring
Asset name for identification and management
Example: Cat Image

Response Parameters

codeinteger
Response status code
  • 0 - Success
  • Other values - Failure
msgstring
Response message, null on success, error message on failure
dataobject
Response data object

Asset Type Description

Image

Supported formats: jpeg, png, webp, bmp, tiff, gif
Used for referenceImages, first_image, last_image parameters

Video

Supported resolutions: 480p, 720p
Used for referenceVideos parameter

Audio

Supported formats: wav, mp3
Used for referenceAudios parameter

Document

Document type assets
Used for other scenarios

Usage Flow

Upload Asset

Call the upload API to obtain assetId

Asset Review

Assets involving faces or virtual avatars need to wait for review approval

Use Asset

Reference the asset in video generation tasks using asset://{assetId} format
Advantages of Using Asset IDs:
  1. Assets are reviewed and comply with platform standards
  2. Assets are stored on the platform for faster access
  3. Avoid issues caused by external URL expiration
  4. Can reuse uploaded assets multiple times
Best Practices:
  • Set meaningful names for assets for easier management
  • Upload images involving faces in advance and wait for review
  • Save the assetId for reuse in multiple video generation tasks
  • Ensure asset URLs are accessible during upload