Create Seedance Video

POST/v1/video/generations
Start an asynchronous Seedance 2.0 video task with text and optional image, video, or audio references. A provider callback does not replace task polling or billing settlement.

Request Body

application/json
model:requiredstring

Public Seedance model name. Supported models are seedance-2-0, seedance-2-0-fast, and seedance-2-0-mini.

Allowedseedance-2-0seedance-2-0-fastseedance-2-0-mini
Exampleseedance-2-0
prompt:requiredstring

Non-empty video generation prompt. Keep it at the top level of the request.

ExampleThe white rabbit in the image is eating an orange
seconds:requiredstring

Video duration in seconds, provided as a JSON string. Supported values are 4 through 15; the default is "5".

Allowed456789101112131415
Example5
images:optionalarray

Reference image URLs using https:// or asset://. Do not send this field together with metadata.content because metadata.content takes precedence.

metadata:optionalobject

Seedance provider options. Explicit false, 0, and -1 values are preserved; unknown fields are ignored by the adapter.

metadata.resolution:optionalstring

Output resolution; the default is 720p. seedance-2-0 supports 480p, 720p, and 1080p; seedance-2-0-fast and seedance-2-0-mini support only 480p and 720p.

Allowed480p720p1080p
Example720p
metadata.ratio:optionalstring

Output aspect ratio. Supported values are 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, and 2:3; the default is 16:9.

Allowed1:116:99:164:33:43:22:3
Example16:9
metadata.content:optionalarray

Reference media items for image, video, audio, or mixed-reference generation. Put text in the top-level prompt. This field overrides images.

metadata.content[].type:requiredstring

Required media type for each reference item: image_url, video_url, or audio_url.

Allowedimage_urlvideo_urlaudio_url
metadata.content[].image_url:optionalobject

Use when type is image_url, together with role=reference_image.

metadata.content[].image_url.url:optionalstring

Image reference URL using https:// or asset://.

Examplehttps://example.com/reference.png
metadata.content[].video_url:optionalobject

Use when type is video_url, together with role=reference_video.

metadata.content[].video_url.url:optionalstring

Video reference URL using https:// or asset://.

Examplehttps://example.com/reference.mp4
metadata.content[].audio_url:optionalobject

Use when type is audio_url, together with role=reference_audio.

metadata.content[].audio_url.url:optionalstring

Audio reference URL using https:// or asset://.

Examplehttps://example.com/reference.mp3
metadata.content[].role:optionalstring

Reference role. Match reference_image, reference_video, or reference_audio to the item's type and URL field.

Allowedreference_imagereference_videoreference_audio
metadata.callback_url:optionalstring

Absolute HTTP or HTTPS URL called directly by the provider. It does not replace UnifyLLM task polling or billing settlement.

Examplehttps://example.com/callback/seedance
metadata.return_last_frame:optionalboolean

Request the provider to return the last frame. The current UnifyLLM task response does not expose a last-frame URL.

metadata.service_tier:optionalstring

Provider service tier: default or flex.

Alloweddefaultflex
metadata.execution_expires_after:optionalinteger

Task execution expiry in seconds, from 3,600 to 259,200.

Example172800
metadata.generate_audio:optionalboolean

Whether to generate audio with the video.

metadata.draft:optionalboolean

Whether to use provider draft mode.

metadata.tools:optionalarray

Tools available during generation. The currently documented tool type is web_search.

metadata.tools[].type:requiredstring

Required tool type. The only supported value in the schema is web_search.

Allowedweb_search
metadata.safety_identifier:optionalstring

Printable ASCII safety identifier, up to 64 characters. Prefer a non-reversible user identifier.

Exampleuser-7f83a19c
metadata.priority:optionalinteger

Task priority from 0 through 9; the default is 0.

Allowed0123456789
Example0
metadata.frames:optionalinteger

Optional total frame count. Supported values follow 25 + 4n from 29 through 289.

Allowed293337414549535761656973778185899397101105109113117121125129133137141145149153157161165169173177181185189193197201205209213217221225229233237241245249253257261265269273277281285289
Example57
metadata.seed:optionalinteger

Random seed from -1 through 4,294,967,295. The default is -1, which requests a random seed.

Example-1
metadata.camera_fixed:optionalboolean

Whether to keep the camera fixed.

metadata.watermark:optionalboolean

Whether to add a watermark.

Response

200

A successful request returns a JSON response. The complete example is shown in the code panel.

Compatibility References

Use these external references to review additional parameters supported by compatible provider formats.