Skip to main content
GET
Get Gemini video task

Polling and status

Replace <OPERATION_NAME> with the full name from creation and poll every 10 to 15 seconds:
done: true means the operation ended, not necessarily that it succeeded.

Read a successful result

Key fields in a successful response:
After success, download the video.

Failures and retries

After a polling disconnect, keep polling the same name rather than calling predictLongRunning again. Correct fields before retrying a 400. If a terminal operation has error, do not read the success response fields. Files remain for 72 hours and task records for 7 days. After a 429 or temporary service error, wait before retrying the read; do not create another task. If a task is missing, check the identifier and the account that owns the API key.

Authorizations

Authorization
string
header
required

API key (sk-xxx)

Path Parameters

model
string
required

Full Seedance model name.

Example:

"doubao-seedance-2-5-260628"

operation
string
required

The identifier after operations/ in the returned name, not the full name.

Example:

"task_example"

Response

Current task state; generation failures can also return HTTP 200.

name
string
required

Full operation name. Save the returned value for polling.

done
boolean
required

False means pending. True means finished, possibly with a failure; check error.

response
object
error
object