Create Video Generation

View as Markdown
Create a BytePlus Seedance video generation task. Returns immediately with ``{"id": "<task_id>"}``. Poll ``GET /v1/video/generations/{id}`` until status is ``succeeded``, ``failed``, or ``expired``. Pass ``callback_url`` to receive a POST notification when the task status changes. We intercept the BytePlus callback, update our DB, then forward the full task payload to your URL.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
modelstringRequired
contentlist of objectsRequired
callback_urlstring or nullOptional
return_last_framebooleanOptionalDefaults to false
service_tierstring or nullOptional
execution_expires_afterinteger or nullOptional
generate_audioboolean or nullOptional
draftboolean or nullOptional
resolutionstring or nullOptional
ratiostring or nullOptional
durationinteger or nullOptional
framesinteger or nullOptional
seedinteger or nullOptional
camera_fixedboolean or nullOptional
watermarkboolean or nullOptional
safety_identifierstring or nullOptional
priorityinteger or nullOptional0-9

Response

Task created; poll the returned id for status

idstring

Errors

401
Unauthorized Error
402
Payment Required Error
422
Unprocessable Entity Error
429
Too Many Requests Error
502
Bad Gateway Error