Generate Media Asset
Starts an AI media generation job billed from the account’s balance. Generation is asynchronous — poll GET /media/{id} until the asset is ready, then use file.id anywhere attachments are accepted.
Authorizations
An account API key, account scoped JWT, app API key, or user OAuth token.
Body
The kind of media to generate.
video, image What to generate. Up to 2,000 characters.
Account ID, prefixed biz_. Defaults to the account the API key belongs to.
Optional reference image file IDs (file_ prefixed), up to 4. For video the first reference seeds the opening frame.
Video length in seconds. Video only; defaults to 5.
5, 10, 15 Video resolution. Video only; defaults to 1080p. 1080p is not supported by Seedance 2.0 Fast or Mini; 4k is only supported by Seedance 2.0.
480p, 720p, 1080p, 4k Response
Generation started.
Media asset ID, prefixed media_.
The kind of media this asset holds.
video, image "video"
How the asset was created. Always generated.
generated "generated"
Lifecycle state: processing while generation runs, ready when the file is available, failed when generation failed and the charge was refunded.
processing, ready, failed "processing"
USD amount charged to the account's balance for this generation. null if the generation wasn't billed.
Currency of amount_charged. Always usd.
Why generation failed. null unless status is failed.
ISO 8601 timestamp when the generation was requested.
ISO 8601 timestamp when the asset reached a terminal state. null while processing.
The inputs the asset was generated from.
The produced file, usable anywhere attachments are accepted. null until the asset is ready.

