Skip to main content
GET
/
vendors
/
google
/
v1
/
veo-3.1
/
generation
/
{task_id}
Get Generation Task
curl --request GET \
  --url https://api.mulerun.com/vendors/google/v1/veo-3.1/generation/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "task_info": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "completed",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "error": {
      "code": 3001,
      "title": "Invalid Request",
      "detail": "The prompt contains prohibited content"
    }
  },
  "videos": [
    "<string>"
  ]
}

​
Overview

Retrieve the status and result of a Veo 3.1 video generation task.

​
Task Status

StatusDescription
pendingTask is waiting to be processed
processingTask is currently being processed
completedTask completed successfully
failedTask failed with an error

​
Response

When the task is completed, the response will include the generated video URLs in the videos array.

​
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.

​
Example Response

​
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

Task result

​
task_info
object
​
videos
string<uri>[]

Generated video URLs (only present when status is completed)