Skip to main content
This guide submits a text-to-video task and polls it until the generated video is ready.
Creating a generation task is billable. Confirm the selected model and controls before sending the request.
1

Create an API key

Open API Keys in the GENGEN Dashboard and create a key.Store the full key when it is shown. GENGEN does not display the secret again.
2

Submit a task

Replace the placeholder key and send the request:
A successful submission returns a public task ID:
3

Retrieve the result

URL-encode the task ID when placing it in the path. For example, encode : as %3A.
Continue polling while the task is pending, queued, running, or processing. When status is completed or succeeded, read the video URL from outputs.videos.

Seedance response details

Seedance 2.0 and 2.5 report successful tasks with status: "completed". Accept both completed and succeeded when handling video results across providers, and read generated media from the standard outputs.videos and outputs.images fields. Completed tasks may include optional usage data after the standard response fields: These fields retain their snake_case names for compatibility. They may be absent, particularly when a task is still in progress. Requests with video references do not necessarily include separate input or video token counts. Usage counts are not the charged price; check the Dashboard for charges. Other compatibility fields, such as task_id, video_url, and content.video_url, may also be present. Use the standard id and outputs fields in new integrations.
Provider output URLs can expire. Copy successful outputs to storage that you control.

Next steps