Skip to main content
POST
Text to video

Authorizations

Authorization
string
header
required

A workspace API key beginning with gengen_live_.

Body

application/json

Normalized GENGEN request for BytePlus Seedance video models. Other upstream providers share this endpoint but have separate reference pages and request parameter sets.

model
enum<string>
required

Supported BytePlus Seedance model IDs:

  • dreamina-seedance-2-0-260128 — Seedance 2.0
  • dreamina-seedance-2-0-fast-260128 — Seedance 2.0 Fast
  • dreamina-seedance-2-0-mini-260615 — Seedance 2.0 Mini
  • seedance-1-5-pro-251215 — Seedance 1.5 Pro
Available options:
dreamina-seedance-2-0-260128,
dreamina-seedance-2-0-fast-260128,
dreamina-seedance-2-0-mini-260615,
seedance-1-5-pro-251215
Example:

"dreamina-seedance-2-0-260128"

mode
enum<string>

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 prompt
  • image_first_frame — animate a first-frame image
  • image_first_last_frame — interpolate between first and last frames
  • multimodal_reference — guide generation with image, video, or audio references
  • video_modify — edit an existing source video
  • video_extend — extend an existing source video
Available options:
text_to_video,
image_first_frame,
image_first_last_frame,
multimodal_reference,
video_modify,
video_extend
prompt
string

Creative text instruction. Required for text_to_video and recommended for every other BytePlus Seedance mode.

contentPreFilter
boolean
default:true

Apply content pre-filtering before submitting the task.

assets
object

Image, video, and audio inputs supported by BytePlus Seedance.

controls
object

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.

id
string
required

Public GENGEN task ID.

model
string
required

Public model ID selected for the task.

status
string
required

Task state. Common values include pending, queued, running, processing, succeeded, completed, failed, cancelled, and expired.

outputs
object
required
createdAt
string<date-time>
updatedAt
string<date-time>
statusUpdateTime
string<date-time>
failureReason
string
created_at

Compatibility timestamp returned by a provider or legacy endpoint.

updated_at

Compatibility timestamp returned by a provider or legacy endpoint.

status_update_time

Compatibility timestamp returned by a provider or legacy endpoint.

failure_reason
string
task_id
string

Compatibility alias for id.

video_url
string<uri> | null

Compatibility alias for the first video output.

videos
string<uri>[]

Compatibility alias for outputs.videos.

enhanced_prompt
string
detail
any
task_info
any
content
any
output
any
data
any
usage
any