Skip to main content

Output Images

Most API endpoints return an OutputImageUrl — an annotated version of the input image with AI analysis results visually overlaid.

How It Works​

  1. You submit a dental image URL via the API
  2. Annie Insights AI processes and annotates the image
  3. The API returns a time-limited Azure Blob SAS URL to download the annotated result

SAS URL Behavior​

PropertyValue
StorageAzure Blob Storage
URL validity72 hours (production), 24 hours (sandbox)
Auto-deletionOutput images are deleted after 3 days
AccessRead-only (sp=r)
Time-Limited Access

Download or cache the output image immediately after receiving the API response. The SAS URL expires and the image is permanently deleted after 3 days.

Example URL​

https://annieapistorage.blob.core.windows.net/api-output-images/clinical-images/a1b2c3d4.jpg?se=2026-05-27&sp=r&sv=2021-08-06&sr=b&sig=...

Best Practices​

  • Download immediately — Don't rely on the URL being available later
  • Store locally — Save output images in your own storage system
  • Cache results — Store the full API response JSON alongside the image
  • Handle expiry — If a URL has expired, re-submit the original image for re-analysis