Skip to main content
GET
/
vendors
/
google
/
v1
/
veo
/
generation
/
{task_id}
Get Veo3 Video Generation Task
curl --request GET \
  --url https://api.mulerun.com/vendors/google/v1/veo/generation/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "task_info": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "completed",
    "created_at": "2025-09-21T00:00:00.000Z",
    "updated_at": "2025-09-21T00:00:00.000Z"
  },
  "videos": [
    "https://mulerouter.muleusercontent.com/public/123e4567-e89b-12d3-a456-426614174000/video.mp4"
  ]
}
This API retrieves the status and result of a Veo3 video generation task. Video generation is asynchronous and may take several minutes to complete.

​
Response Status

The status field in the response indicates the current state of the task:
  • pending: Task is queued and waiting to be processed
  • processing: Task is currently being executed
  • completed: Task completed successfully, video URLs are available
  • failed: Task failed, error details are provided

​
Video Retention

Generated videos are stored on the server for 2 days, after which they are automatically deleted. Make sure to download your videos within this timeframe.

​
Response Example

​
Completed Task

{
  "task_info": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "completed",
    "created_at": "2025-09-21T00:00:00Z",
    "updated_at": "2025-09-21T00:00:10Z"
  },
  "videos": [
    "https://mulerouter.muleusercontent.com/public/123e4567-e89b-12d3-a456-426614174000/video.mp4"
  ]
}

​
Failed Task

{
  "task_info": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "failed",
    "created_at": "2025-09-21T00:00:00Z",
    "updated_at": "2025-09-21T00:00:10Z",
    "error": {
      "code": 3001,
      "title": "Task Execution Error",
      "detail": "Video generation failed due to invalid prompt"
    }
  }
}

​
Polling Recommendations

Since video generation is a long-running operation:
  1. Poll the task status every 10-15 seconds
  2. Maximum generation time can be up to 6 minutes during peak hours
  3. Minimum generation time is typically 11 seconds

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
task_id
string<uuid>
required

Response

200 - application/json

Task completed successfully

​
task_info
object
​
videos
string<uri>[]

URL of the generated video

Example:
[
  "https://mulerouter.muleusercontent.com/public/123e4567-e89b-12d3-a456-426614174000/video.mp4"
]