Upload an image

Store one private, immutable PNG, JPEG, or WebP image. Send the raw bytes with the matching Content-Type. Maximum 10 MiB, 7680 by 4320 stored pixels, 32 million pixels, and 64 MiB decoded memory. Animated images are refused. Images and brand assets share an account limit of 100 files and 100 MiB. Use the returned reference in an HTML body img src, or in template data for an img src. Render creation checks ownership after template expansion and captures the exact bytes. References are not public URLs. PDF header and footer templates do not support image references. No render credit is charged for an upload.

post/v1/image-assets

Request

  • Base URL: https://thirds.ai
  • URL: https://thirds.ai/v1/image-assets
  • Auth: HTTP bearer

Response

The image is stored.

idstring required
referencestring required

Private template reference. This is not a fetchable URL.

media_type'image/png' | 'image/jpeg' | 'image/webp' required
byte_sizeinteger required
widthinteger required

Display width after image orientation.

heightinteger required

Display height after image orientation.

Changes

No recorded changes to this operation across all 1 revision of this API.