CDN Integration

Every generated headshot is available on the Grasco CDN in multiple sizes and image modes. You can use the CDN URLs directly in you site, OG images, native apps, or anywhere you need an image — no SDK or UI component required.

URL Format

{baseUrl}/profile-picture/cdn/{extCustomerId}_{size}_{imageMode}.webp

For example:

https://api.propicture.app/profile-picture/cdn/user-123_480_original.webp

Parameters

Parameter	Description
`extCustomerId`	The external customer ID used when creating the session
`size`	CDN resolution in pixels — see available sizes below
`imageMode`	`original` or `transparent`

Image Modes

Mode	Description
`original`	Original uploaded image with background
`transparent`	Image with background removed

Available Sizes

Five resolutions are available:

Size	Resolution
`80`	80px
`120`	120px
`240`	240px
`480`	480px
`960`	960px

Choose the size closest to your display dimensions. For retina displays, request 2x the display size.

Examples

<!-- Avatar in an email (120px) -->
<img src="https://api.propicture.app/profile-picture/cdn/user-123_120_original.webp" />

<!-- OG image (960px) -->
<img src="https://api.propicture.app/profile-picture/cdn/user-123_960_original.webp" />

<!-- Transparent background for compositing -->
<img src="https://api.propicture.app/profile-picture/cdn/user-123_480_transparent.webp" />

Custom CDN Endpoint (Enterprise)

The default CDN base URL (https://api.propicture.app) works out of the box for all users. Enterprise customers with a dedicated endpoint can use their custom URL:

https://cdn.your-company.com/profile-picture/cdn/user-123_480_original.webp