Create Express Request

This section allows you to create an express request

Create Express Video Request

post

Simplified interface for creating new video enhancement requests.

This endpoint skips the need to gather video information and uses a single-URL upload rather than multi-part upload. Calling the accept and complete-upload endpoints are also no longer necessary.

This endpoint does not return the cost estimates. Once the system receives and analyzes the source video file, cost estimates will appear in the response of the status endpoint. The lower bound value will be billed.

The endpoint returns a direct upload URL to our cloud storage for you to HTTP PUT the video file to.

Response body

Property	Type	Description
requestId	UUID	Unique request identifier
uploadId	String	Upload identifier
uploadUrls	Array	URL(s) for uploading video

Authorizations

apiKey

X-API-KeystringRequired

Body

application/json

Responses

200

Successful response

application/json

requestIdstring · uuidOptionalExample: c1f96dc2-c448-00e6-82ed-14ecb6403c62

uploadIdstringOptional

Upload ID for completing multi-part upload

Example: GDlWC7qIaE6okS41Xf/ktpuS5XzTRabg

uploadUrlsstring[]Optional

URL to PUT the parts to

Example: ["https://videocloud.s3.amazonaws.com/0193893a-a2ba-799e-b258-928f02c0f419/source.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256...x-id=PutObject"]

400

Bad request

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

503

Service unavailable

application/json

post

/video/express

HTTPcURLJavaScriptPython

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

{
  "source": {
    "container": "mp4",
    "md5Hash": "5d41402abc4b2a76b9719d911017c592",
    "external": {
      "provider": "s3",
      "presignedUrl": "https://videocloud.s3.amazonaws.com/0193893a-a2ba-799e-b258-928f02c0f419/output.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256...x-id=PutObject",
      "awsCredentials": {
        "roleArn": "arn:aws:iam::123456789:role/topazlabs",
        "externalId": "MSTnuGztXtTU25XKjVfMJCsujv6VtAGtv1TGSjtOL6M="
      },
      "bucketName": "galaxies",
      "key": "milky_way/%06d.tiff"
    }
  },
  "filters": [
    {
      "model": "prob-4",
      "videoType": "Progressive",
      "auto": "Auto",
      "fieldOrder": "Auto",
      "focusFixLevel": "Normal",
      "compression": 0.1,
      "details": 0.2,
      "prenoise": 0.01,
      "noise": 0.3,
      "halo": 0.4,
      "preblur": 0.5,
      "blur": 0.6,
      "grain": 0.02,
      "grainSize": 1,
      "recoverOriginalDetailValue": 0.7
    },
    {
      "model": "apo-8",
      "slowmo": 2,
      "fps": 60,
      "duplicate": true,
      "duplicateThreshold": 0.01
    }
  ],
  "output": {
    "resolution": {
      "width": 7680,
      "height": 4320
    },
    "frameRate": 30,
    "audioBitrate": "320",
    "audioCodec": "AAC",
    "audioTransfer": "Copy",
    "codecId": "h265-main-win-nvidia",
    "videoEncoder": "H265",
    "videoBitrate": "1k",
    "dynamicCompressionLevel": "Mid",
    "videoProfile": "Main",
    "cropToFit": true,
    "container": "mp4"
  },
  "destination": {
    "external": {
      "provider": "s3",
      "presignedUrl": "https://videocloud.s3.amazonaws.com/0193893a-a2ba-799e-b258-928f02c0f419/output.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256...x-id=PutObject",
      "awsCredentials": {
        "roleArn": "arn:aws:iam::123456789:role/topazlabs",
        "externalId": "MSTnuGztXtTU25XKjVfMJCsujv6VtAGtv1TGSjtOL6M="
      },
      "bucketName": "galaxies",
      "key": "milky_way/%06d.tiff"
    }
  },
  "notifications": {
    "webhookUrl": "https://www.myvideos.com/webhooks/topazlabs"
  }
}

{
  "requestId": "c1f96dc2-c448-00e6-82ed-14ecb6403c62",
  "uploadId": "GDlWC7qIaE6okS41Xf/ktpuS5XzTRabg",
  "uploadUrls": [
    "https://videocloud.s3.amazonaws.com/0193893a-a2ba-799e-b258-928f02c0f419/source.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256...x-id=PutObject"
  ]
}