v1

latestOpenAPI 3.1.0Commercial2026-07-26232551.7 KB

Seedance Assets

Upload an asset (image / video / audio)

Upload an asset into a group you own. Assets are provided as a publicly accessible URL only (no base64, no file body). The call is asynchronous — poll GET /asset/files/{aid} until Status becomes Active. For a real-human group, the uploaded image's face is compared against the verified reference; a mismatch resolves to Status: Failed with Error.Code: FaceMismatch.

Subject to the asset upload cap (default 100).

post/asset/files

Request body

GroupIdstring required

The id of a group you own.

URLstring required

Publicly accessible image / video / audio URL.

AssetType'Image' | 'Video' | 'Audio' required

Namestring

Optional; used only for ListAssets fuzzy search.

Moderationobject

Optional. {"Strategy":"Skip"} to skip content pre-filter.

Response

Asset accepted (async — poll GET /asset/files/{id})

Idstring