Get Sora 2 Pro Generation Task

Retrieve the status and result of a Sora 2 Pro video generation task

GET /vendors/openai/v1/sora-2-pro/generation/{task_id}

Get Sora 2 Pro Video Generation Task

cURL

curl --request GET \
  --url https://api.mulerun.com/vendors/openai/v1/sora-2-pro/generation/{task_id} \
  --header 'Authorization: Bearer <token>'

200

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

This API retrieves the status and result of a Sora 2 Pro 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

Generation Time

Sora 2 Pro may take longer than Sora 2 due to higher quality processing:

• Typically 3-8 minutes for standard requests
• Higher resolution and longer duration may increase processing time

Video Retention

Download URLs are valid for a maximum of 1 hour after generation. If you need long-term storage, copy the file to your own storage system promptly.

Response Examples

Completed Task

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

Processing Task

{
  "task_info": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "processing",
    "created_at": "2025-09-21T00:00:00Z",
    "updated_at": "2025-09-21T00:03:00Z"
  }
}

Failed Task

{
  "task_info": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "failed",
    "created_at": "2025-09-21T00:00:00Z",
    "updated_at": "2025-09-21T00:01:30Z",
    "error": {
      "code": 3001,
      "title": "Task Execution Error",
      "detail": "Video generation failed: Prompt contains restricted content"
    }
  }
}

Polling Recommendations

Since video generation is a long-running operation:

1. Poll the task status every 15-30 seconds
2. Use exponential backoff if necessary to reduce API load
3. Maximum generation time can be up to 15 minutes for high-quality renders
4. Provide feedback to users that the job is still in progress

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

Show child attributes

videos · string<uri>[]

URL of the generated video

Example:

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