Download
Access presigned URLs for downloading input or processed images. These endpoints allow you to securely retrieve the input or the processed image with an expiring URL.
A presigned download link to the image is provided in the response, as well as an expiration time (in Unix time). If the image is not ready, this request will fail with a conflict error. Images are stored for 7 days after the image has been processed.
Authentication via the Topaz generated key in the X-API-Key header.
The UUID of the image processing job.
Presigned download URL
The request contains malformed data in the body, path, or query parameters.
Authentication is required and has failed or has not yet been provided.
The API key doesn't have permissions to perform the request.
The requested resource does not exist.
The request conflicts with the current state.
Too many requests hit the API too quickly. A backoff (e.g. exponential) is recommended for your requests.
Unexpected error on our end.
GET /image/v1/download/{process_id} HTTP/1.1
Host: api.topazlabs.com
X-API-Key: YOUR_API_KEY
Accept: */*
{
"download_url": "https://<...>/d7b3b3b3-7b3b-4b3b-8b3b-3b3b3b3b3b3b?<presigned_headers>",
"head_url": "https://<...>/d7b3b3b3-7b3b-4b3b-8b3b-3b3b3b3b3b3b?<presigned_headers>",
"expiry": 1617220000
}A presigned download link to the input image is provided in the response, as well as an expiration time (in Unix time). Input images are stored for 7 days after the image has been uploaded.
Authentication via the Topaz generated key in the X-API-Key header.
The UUID of the image processing job.
Presigned download URL
The request contains malformed data in the body, path, or query parameters.
Authentication is required and has failed or has not yet been provided.
The API key doesn't have permissions to perform the request.
The requested resource does not exist.
Too many requests hit the API too quickly. A backoff (e.g. exponential) is recommended for your requests.
Unexpected error on our end.
GET /image/v1/download/input/{process_id} HTTP/1.1
Host: api.topazlabs.com
X-API-Key: YOUR_API_KEY
Accept: */*
{
"download_url": "https://<...>/d7b3b3b3-7b3b-4b3b-8b3b-3b3b3b3b3b3b?<presigned_headers>",
"head_url": "https://<...>/d7b3b3b3-7b3b-4b3b-8b3b-3b3b3b3b3b3b?<presigned_headers>",
"expiry": 1617220000
}Last updated