The poster generation endpoint always returns a download_url that points to a CDN-hosted asset. The format is determined by the format field.

Supported formats

| Format | Use case | Notes | | ------ | -------- | ----- | | png | Print, archival | Lossless, largest filesize | | webp | Web embedding | ~30% smaller than PNG | | pdf | Print-on-demand | Includes a CMYK color profile |

Selecting a format

const poster = await client.posters.generate({
  location: { lat: 41.9028, lng: 12.4964 },
  style: 'minimal',
  format: 'pdf',
});

Asset lifetime

download_url values are valid for 24 hours after generation. Persist the asset to your own storage if you need longer retention.

Webhook delivery (preview)

For long renders, you can subscribe to poster.completed events. See Rate Limits and Errors for retry guidance.