Asset Library

Node name: BytePlus Asset Library
Node ID: BytePlusAssetLibrary
Find it: Double-click the canvas and search for “Asset Library”, or browse BytePlus ModelArk
Keys needed: ModelArk API key, IAM access key and secret key
Runs when: It is an output node: it runs on its own, whenever the workflow is queued.

What it does

Lists the assets in your private asset library, which holds virtual portraits and verified real people for Seedance 2 and 2.5. Use it to find an asset you made earlier, or one created in the ModelArk console, and pass it to a Seedance node.

It needs the ModelArk API key and the IAM access key and secret key saved in Settings → BytePlus (see API keys), plus Dreamina Seedance Advanced Creation Rights. It only lists assets and creates nothing.

On the canvas

The Asset Library node with group_type AIGC, status Active and max_results 20 — Default values: Active virtual portrait assets, at most 20.

Inputs

Input	Type	Default	What it does
`group_type`	choice	`AIGC`	Choices: AIGC, LivenessFace
`group_id`	text		Only assets in this group (optional).
`status`	choice	`Active`	Choices: all, Active, Processing, Failed
`name`	text		Filter by asset name (optional).
`max_results`	integer	`20`	Range: 1–100
`project_name`	text	`default`

Notes on inputs

Group type: AIGC lists virtual portraits. LivenessFace lists verified real people.
Filters: group_id and name are optional and stay out of the request while empty. status defaults to Active, the status a Seedance reference needs. Choose all to also see Processing and Failed assets.
Results: max_results goes from 1 to 100. The node asks once and does not page, so narrow the filters if the asset you want is missing.
Project: project_name is the ModelArk project that holds the library, default unless you use another.

Outputs

Output	Type	What it holds
`asset_uris`	text
`assets_json`	text

Notes on outputs

asset_uris has one asset:// URI per line.
assets_json is a JSON list. Each entry has asset_id, asset_uri, name, group_id, asset_type, status and create_time.
An asset_N slot of Seedance 2.5 Reference to Video takes one asset only. To connect asset_uris to a slot, filter to one asset first, for example with name and max_results set to 1.

Limits and tips

The node is an output node, so it runs even when nothing is connected to it.
Copy an ID from assets_json into first_frame_asset_id or last_frame_asset_id on Seedance 2.5 First-Last-Frame to Video.
Using an asset in Seedance needs only the ModelArk key, except that an asset_N slot looks up the asset’s type and status with your IAM keys. With IAM keys saved, the two frame inputs check the asset the same way; without them the ID is sent as it is.
A checked asset must be Active, so a Processing or Failed asset is refused.
To make new assets, use Create Image Asset, Create Video Asset or Create Audio Asset.

Common errors

Message	What to do
`[BytePlus] No BytePlus API key is set. Add it in Settings > BytePlus …`	Add your ModelArk key in Settings → BytePlus. See API keys.
`[BytePlus] The asset library needs IAM AK/SK with asset-library permission …`	Add the IAM access key and secret key in Settings → BytePlus.
`… Check the IAM AK/SK in Settings > BytePlus.`	The keys were rejected. Re-enter them and check that they are for the right account.
`… The IAM user needs asset-library permission in this project, and the account needs Dreamina Seedance Advanced Creation Rights.`	Give the IAM user asset-library permission in this project. The account also needs Advanced Creation Rights.