Overview
This endpoint retrieves the status and result of a video generation operation. After submitting a video generation request, use this endpoint to check if the operation is complete and retrieve the generated video.
Authentication
This endpoint requires authentication using an API key.
x-goog-api-key
string
default: "sk-***********"
required
Your API key in the format: YOUR_API_KEY
Parameters
model_name
string
default: "veo-3.1-generate-preview"
required
The name of the model used for the video generation request
operation_id
string
default: "mg3pt9cbmvr1"
required
The operation ID returned from the video generation request
Request Example
curl --location 'https://api.gptproto.com/v1beta/models/veo-3.1-generate-preview/operations/mg3pt9cbmvr1' \
--header 'x-goog-api-key: YOUR_API_KEY'
Response
Successful response when operation is complete {
"name" : "operations/mg3pt9cbmvr1" ,
"metadata" : {
"@type" : "type.googleapis.com/google.cloud.aiplatform.v1beta1.GenerateVideoMetadata" ,
"createTime" : "2025-01-19T00:00:00Z" ,
"updateTime" : "2025-01-19T00:05:00Z"
},
"done" : true ,
"response" : {
"@type" : "type.googleapis.com/google.cloud.aiplatform.v1beta1.GenerateVideoResponse" ,
"generatedSamples" : [
{
"video" : {
"uri" : "https://generativelanguage.googleapis.com/v1beta/files/generated-video-id:download?alt=media"
}
}
]
}
}
Response when operation is still in progress {
"name" : "operations/mg3pt9cbmvr1" ,
"metadata" : {
"@type" : "type.googleapis.com/google.cloud.aiplatform.v1beta1.GenerateVideoMetadata" ,
"createTime" : "2025-01-19T00:00:00Z" ,
"updateTime" : "2025-01-19T00:02:00Z"
},
"done" : false
}
Error Responses
401 - Invalid signature
403 - Invalid Token
404 - Operation not found
500 - Internal server error
{
"error" : {
"message" : "Invalid signature" ,
"type" : "401"
}
}