Skip to main content
GET
Get task result by taskId
Shared polling endpoint for both Gemini Video (Veo) and Gemini Image (Nano Banana) async tasks.
Create a task with Generate Video or Generate Image, then poll this endpoint with the returned taskId until status is completed, failed, or timeout.

Used By

Task Status Values

Poll every 3–5 seconds. Image tasks are usually faster than video; video generation may take longer depending on model and length.

Authorizations

Authorization
string
header
required

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

Query Parameters

taskId
string
required

Response

200 - application/json
taskId
string
required

task id

status
enum<string>
required

task status

Available options:
pending,
ready,
assigned,
processing,
completed,
failed,
cancelled,
timeout
result

task result

errorMessage
string

error message

errorCode
number

error code

finishedAt
string<date-time>

task finished time

createdAt
string<date-time>

task created time

traceId
string

traceId