Skip to main content
POST
Create asset
For a complete portrait tutorial, see Generate videos with face assets. It covers manual Group and Asset creation with JSON examples, as well as sending an HTTPS URL directly to the Seedance video task API for automatic asset preparation.

Authorizations

Authorization
string
header
required

A workspace API key beginning with gengen_live_.

Body

application/json
GroupId
string
required

Provider asset group ID for an active group owned by the workspace.

Minimum string length: 1
URL
string<uri>
required

Publicly reachable asset URL. Base64 uploads are not supported.

File requirements:

  • Images: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, or HEIF; aspect ratio between 0.4 and 2.5; each dimension over 300 px and under 6,000 px; under 30 MB
  • Videos: MP4 or MOV; 480p, 720p, 1080p, or 4K; 2–30 seconds; aspect ratio from 0.4 through 2.5; each dimension from 300 px through 6,000 px; 407,696–8,295,044 total pixels; 24–60 FPS; up to 200 MB
  • Audio: WAV or MP3; 2–30 seconds; up to 15 MB
AssetType
enum<string>
required

Supported asset types:

  • Image — image asset
  • Video — video asset
  • Audio — audio asset
Available options:
Image,
Video,
Audio
Name
string

Asset name used for management and fuzzy search.

Maximum string length: 64
Moderation
object

Response

The asset was accepted for preprocessing.

ResponseMetadata
object
required
Result
object
required