Skip to main content
POST
Enqueue generation

Body

application/json

Queue request

Enqueue an async image or video generation job. prompt is required unless draft_task_id renders the final video from a Seedance draft, which reuses the draft's prompt, media, and settings.

model
string
required

Model ID to use

aspect_ratio
string | null
draft
boolean | null

Seedance 2.5: render a quick 480p draft whose draft_task_id can render the final video.

draft_task_id
string | null

Seedance 2.5: render the final 1080p video from this draft. No prompt is needed.

duration
integer | null
num_generations
integer
default:1
Required range: 1 <= x <= 12
prompt
string | null

Text prompt for generation

seed
integer | null
target_directory
string | null
target_namespace
string | null

Namespace to store results. Defaults to current user.

target_repo
string | null
workbench_session_id
string<uuid> | null

Workbench session (tab) this generation belongs to. Must name an existing, non-deleted session on the target repository that the caller may use.

Response

Generation enqueued

generations
object[]
required