Download generated file
GET/v1/visual/:request-id/file/:file-id
Download a specific file generated by a completed visual request.
Important Notes:
- The complete download URL is provided in the
generated_filesarray from the status endpoint - you don't need to construct it manually - Authentication headers are required to download the file content
- Files should be downloaded and hosted elsewhere for display purposes - do not use these URLs directly for displaying visuals in your application
- Both status and file URLs expire after 30 minutes from generation
Files are only available for requests with status "completed". The response will include appropriate Content-Type headers based on the file format.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 410
- 429
- 500
- 503
File downloaded successfully
Response Headers
MIME type of the file
image/svg+xmlSize of the file in bytes
245760A path parameter is not the identifier form the route expects
The bearer token was accepted once and is no longer usable. Mint or refresh a token; retrying the same one never succeeds.
No usable credential was sent, the credential is not one this API accepts, the grant lacks the scope, or the resource belongs to another caller.
The request, or that file of it, does not exist
The request completed too long ago to still be readable. Its files are gone; create a new request.
Repeated bad credentials from this address are being refused. This endpoint is not rate limited, so this is the only 429 it answers, and it carries no Retry-After, no rate limit headers and none of the window fields a rate limit refusal adds.
The call failed on our side and may be retried
A dependency is down or slow: the database, the queue, or the storage a download reads from. The call may be retried with backoff. A download answering this has not lost the file; storage could not be read.