Uploads

Upload the customer's car photo once, then use it for as many renders as you like: three wheels on the same car is one upload and three renders.

Upload a car photo#

POST /v1/uploads, as multipart/form-data with one field, file.

curl https://app.viztunr.com/api/v1/uploads \
  -H "Authorization: Bearer $VIZTUNR_KEY" \
  -F file=@customer-car.jpg
  • JPEG, PNG, WebP, HEIC, or HEIF, up to 10 MB.
  • Send the right content type for the file part; curl does this for you from the file name.
  • Uploads are free. Only renders use your balance.
  • One clear photo of the whole car works best, ideally a three-quarter angle in good light.

Response, 201 Created:

{
  "id": "upl_269c9fcbc7154983b2124958d8e4c58e",
  "url": "https://api.viztunr.com/storage/v1/object/public/shop-uploads/.../269c9fcb.jpg",
  "content_type": "image/jpeg",
  "size_bytes": 719808,
  "created_at": "2026-11-14T07:35:36Z"
}
FieldWhat it is
idPass it as upload when you start a render
urlWhere the photo is stored, for showing a "before" image
content_type, size_bytesAs received

Uploads are kept until you delete them.

Errors#

CodeStatusWhy
parameter_missing400The body has no file field, or isn't multipart
file_too_large413The file is over 10 MB
unsupported_image_type422Not JPEG, PNG, WebP, HEIC, or HEIF

Delete an upload#

DELETE /v1/uploads/:id removes the car photo. Renders already made from it keep their result image.

curl -X DELETE https://app.viztunr.com/api/v1/uploads/upl_269c9fcbc7154983b2124958d8e4c58e \
  -H "Authorization: Bearer $VIZTUNR_KEY"

Answers 204 No Content, or 404 with code upload_not_found if it doesn't exist or belongs to another shop. When a customer asks you to delete their data, delete their uploads and their renders.