Accept Request

This section allows you to accept the created request's cost and upload the source video

Accept and Upload Video Request

patch

Calling this endpoint reserves the estimated credits and returns signed URL(s) for multi-part upload.

Video uploads

The Video API uses multi-part upload to receive the video file for processing. You can use a simple byte-division function to create segments for the API to receive.

For example, if you have a 900MB video file and the system returns 3 upload URLs. You would then:

• Upload bytes 0-300,000,000 via HTTP PUT to urls[0]
• Upload bytes 300,000,001-600,000,000 via HTTP PUT to urls[1]
• Upload bytes 600,000,001-900,000,000 via HTTP PUT to urls[2]

If one of the uploads fail, you may reuse the same URL to retry - the action overwrites any partially uploaded data.

A successful response from the PUT request returns an ETag value in the header for each segment. Retain the part number and ETag pair for the next step (PATCH /video/{requestId}/complete-upload/).

Response body

Property	Type	Description
uploadId	String	Upload ID for multi-part upload
urls	Array	URLs for multi-part uploads

Authorizations

apiKey

X-API-KeystringRequired

Path parameters

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

Responses

202

Successful response

application/json

uploadIdstringOptional

Upload ID for completing multi-part upload

Example: GDlWC7qIaE6okS41Xf/ktpuS5XzTRabg

urlsstring[]Optional

URLs to PUT the parts to. The source video should be split into urls.length number of byte ranges.

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

messagestringOptional

The endpoint will return message only if the video will be sourced from an external storage provider

Example: Accepted

400

Bad request

application/json

401

Unauthorized

application/json

402

Payment required

application/json

403

Forbidden

application/json

404

Enhancement request with the provided ID not found

application/json

500

Internal server error

application/json

503

Service unavailable

application/json

patch/video/{requestId}/accept

HTTPcURLJavaScriptPython

PATCH /video/{requestId}/accept HTTP/1.1
Host: api.topazlabs.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "uploadId": "GDlWC7qIaE6okS41Xf/ktpuS5XzTRabg",
  "urls": [
    "https://videocloud.s3.amazonaws.com/0193893a-a2ba-799e-b258-928f02c0f419/source.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256...x-id=UploadPart",
    "https://videocloud.s3.amazonaws.com/0193893a-a2ba-799e-b258-928f02c0f419/source.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256...x-id=UploadPart"
  ],
  "message": "Accepted"
}