Create a video generation task
Submit an asynchronous BytePlus Seedance video generation task. This reference intentionally documents only the BytePlus models and parameters, even though other providers use the same public GENGEN endpoint.
Authorizations
A workspace API key beginning with gengen_live_.
Body
Normalized GENGEN request for BytePlus Seedance video models. Other upstream providers share this endpoint but have separate reference pages and request parameter sets.
Supported BytePlus Seedance model IDs:
dreamina-seedance-2-0-260128— Seedance 2.0dreamina-seedance-2-0-fast-260128— Seedance 2.0 Fastdreamina-seedance-2-0-mini-260615— Seedance 2.0 Miniseedance-1-5-pro-251215— Seedance 1.5 Pro
dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini-260615, seedance-1-5-pro-251215 "dreamina-seedance-2-0-260128"
Generation mode. If omitted, GENGEN attempts to infer the mode from
the supplied assets. Seedance 2.0, 2.0 Fast, and 2.0 Mini support all
six values. Seedance 1.5 Pro supports only text_to_video,
image_first_frame, and image_first_last_frame.
Supported values:
text_to_video— generate from a text promptimage_first_frame— animate a first-frame imageimage_first_last_frame— interpolate between first and last framesmultimodal_reference— guide generation with image, video, or audio referencesvideo_modify— edit an existing source videovideo_extend— extend an existing source video
text_to_video, image_first_frame, image_first_last_frame, multimodal_reference, video_modify, video_extend Creative text instruction. Required for text_to_video and recommended
for every other BytePlus Seedance mode.
Apply content pre-filtering before submitting the task.
Image, video, and audio inputs supported by BytePlus Seedance.
Output and task controls supported by BytePlus Seedance.
Response
The task was accepted or completed synchronously by the selected provider.
Standard task fields are listed first. Additional provider-native and legacy aliases can be appended for compatibility.
Public GENGEN task ID.
Public model ID selected for the task.
Task state. Common values include pending, queued, running,
processing, succeeded, completed, failed, cancelled, and
expired.
Compatibility timestamp returned by a provider or legacy endpoint.
Compatibility timestamp returned by a provider or legacy endpoint.
Compatibility timestamp returned by a provider or legacy endpoint.
Compatibility alias for id.
Compatibility alias for the first video output.
Compatibility alias for outputs.videos.