Skip to main content
POST
Create a Seedance video generation task
Authenticate with Authorization: Bearer <API_KEY>. Tasks run asynchronously: a successful call only returns the task ID. Call Get video generation task for the result.

Models

Available durations, resolutions, aspect ratios and pricing depend on what is enabled for your account.

content items

  • url can be an asset in the asset library with Status=Active (asset://<asset ID>), or a publicly reachable HTTP(S) URL. See Asset library for importing assets.
  • In the prompt, refer to reference media as “image 1”, “audio 1”, “video 1” by their order within each type in content.
  • Audio cannot be the only reference media; combine it with an image or video.
  • audio_url is an input reference, while generate_audio controls whether the output video has sound. They are independent. Set generate_audio to true when using a reference audio or the original sound of a reference video.

Asset reference errors

When a referenced asset cannot be used, HTTP 400 is returned with error.code set to InvalidParameter:

Error codes

If a create request times out or the connection drops, the task may already have been created. Retrying blindly can create duplicate tasks.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
string
required

Model ID.

Example:

"dreamina-seedance-2-0-260128"

content
object[]
required

Array of prompt text and reference media. In the prompt, refer to media as "image 1", "audio 1", "video 1" by their order within each type.

duration
integer

Video length in seconds.

Example:

5

resolution
string

Output resolution, for example 720p.

Example:

"720p"

ratio
string

Aspect ratio, for example 16:9 or 1:1.

Example:

"16:9"

generate_audio
boolean

Whether to generate sound. Set to true when using a reference audio or the original sound of a reference video.

watermark
boolean

Whether to add a watermark.

priority
integer

Task priority. Echoed back in the query result when provided.

safety_identifier
string

End-user identifier. Use an irreversible hash. Echoed back in the query result when provided.

Response

Task created

id
string
required

Task ID.