latestOpenAPI 3.1.22026-08-10223187.9 KB
7610937217a4
Get Request Status
Get Video Request Status
Get status of the request.
If processing is complete, the response will include a signed URL to access the enhanced video.
Make sure to download and save the video within the TTL provided in the response (24 hours by default). New URLs with new TTL can be generated by calling this endpoint, but we retain your data for only a limited number of days. The video will be permanently deleted from our system afterwards.
Response body
| Property | Type | Description |
|---|---|---|
| status | String | Current processing status |
| progress | Number | Total request progress (percentage) |
| estimates | Object | Refer to RequestEstimates |
| outputSize | String | Size of output video |
| averageFps | Number | Average FPS of processing nodes |
| combinedFps | Number | Combined FPS of all nodes |
| processingJobs | Array | Refer to VideoProcessingStatIntermediate below |
| download | Object | Refer to EnhancedDownloadSignedUrlResponse below |
RequestEstimates
cost and time are arrays with two integers each, representing lower and upper bounds of the estimate.
| Property | Type | Description |
|---|---|---|
| cost | Array | Cost range (in credits) |
| time | Array | Time range (in seconds) |
VideoProcessingStatIntermediate
| Property | Type | Description |
|---|---|---|
| chunkId | UUID | Unique chunk identifier |
| chunkIndex | Integer | Index of the chunk |
| taskIndex | Integer | Task index for chunk processing |
| status | String | Status (queued, processing, complete, etc.) |
| gpuUtilization | Integer | GPU utilization in percentage |
| gpuMemoryUtilization | Integer | GPU memory usage percentage |
| fps | Number | Processing speed of the node |
| progress | Number | Processing progress (percentage) |
EnhancedDownloadSignedUrlResponse
| Property | Type | Description |
|---|---|---|
| url | String | Signed download URL for the enhanced file |
| expiresIn | Integer | TTL in milliseconds |
| expiresAt | Integer | Time in milliseconds since UTC epoch |
get/video/{requestId}/status
Path parameters
requestIdstring uuid required
Response
Successful response