Create Request

This section allows you to create a request and estimate costs

Create Video Request

post

Create a new video enhancement request.

Send information about the video and desired enhancements then receive cost and time estimates.

Calling this endpoint does NOT consume credits.

Estimations are based on values provided, and the calculation is rerun once the system receives the source video. If the second estimate is significantly different than the initial values, the request is failed and the credits are fully refunded.

Time estimates are in development and may not be accurate.

Response body

Property

Type

Description

requestId

UUID

Unique request identifier

estimates

Object

Refer to RequestEstimates 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)

Authorizations
X-API-KeystringRequired
Body
one ofOptional
or
Responses
200

Successful response

application/json
post
/video/
POST /video/ HTTP/1.1
Host: api.topazlabs.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 353

{
  "source": {
    "container": "mp4",
    "size": 16125151,
    "duration": 213,
    "frameCount": 6371,
    "frameRate": 30,
    "resolution": {
      "width": 1280,
      "height": 720
    }
  },
  "filters": [
    {
      "model": "prob-4"
    }
  ],
  "output": {
    "frameRate": 30,
    "audioTransfer": "Copy",
    "audioCodec": "AAC",
    "videoEncoder": "H265",
    "videoProfile": "Main",
    "dynamicCompressionLevel": "High",
    "resolution": {
      "width": 3840,
      "height": 2160
    }
  }
}
{
  "requestId": "c1f96dc2-c448-00e6-82ed-14ecb6403c62",
  "estimates": {
    "cost": [
      10,
      12
    ],
    "time": [
      600,
      700
    ]
  }
}

Last updated