Getting Started with Annie Insights API

Welcome to the Annie Insights API — a comprehensive suite of AI-powered dental analysis endpoints that transform dental images into actionable clinical insights.

What You Can Do

The Annie Insights API provides 13 endpoints covering:

Category	Endpoints	Description
Detection	Clinical Findings, Panoramic Findings	Object detection for decay, restorations, brackets
Segmentation	Frontal, Panoramic, Occlusogram (Upper/Lower)	Pixel-level tooth boundary detection
Landmark Detection	Lateral Ceph, Frontal Ceph	169 lateral + 118 frontal cephalometric landmarks
Classification	Craniofacial Classifier	Image type and orientation recognition
Analysis	TMJ Cross-Sectional	Joint abnormality detection
Prediction	Treatment Length Estimator	ML-based treatment duration prediction

Quick Start — First API Call in 5 Minutes

Step 1: Get Your API Key

Contact our team at api-support@hcds.ai to request an API key. For testing, use the sandbox key:

SANDBOX_KEY_FOR_TESTING_ONLY

Sandbox Limitations

The sandbox key has a rate limit of 10 requests/minute and returns watermarked output images. Do not use in production.

Step 2: Make Your First Request

Send a dental image to the Clinical Findings endpoint:

curl -X POST \
  https://api.annie-insights.com/api/v2/clinical-images \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "PatientID": "P-001",
    "TimeStamp": "2026-05-24",
    "ImageName": "https://example.com/dental-photo.jpg"
  }'

Step 3: Receive Results

The API returns structured JSON with detection results and an annotated output image:

{
  "Version": "2024.1.0",
  "PatientID": "P-001",
  "TimeStamp": "2026-05-24",
  "ImageName": "dental-photo.jpg",
  "ImageContents": {
    "decay": 2,
    "restoration": 1
  },
  "Results": {
    "decay": [
      {"ClassName": "decay", "TopLeft": [120, 80], "BottomRight": [200, 160]}
    ]
  },
  "OutputImageUrl": "https://annieapistorage.blob.core.windows.net/..."
}

Output Images

The OutputImageUrl is a time-limited Azure Blob SAS URL valid for 72 hours. Download or cache the image before expiry. See Output Images for details.

Base URL

All API requests use the following base URL:

https://api.annie-insights.com/api/v2

Authentication

Every request must include an x-api-key header. See Authentication for details.

Next Steps

• Authentication — Learn about API key management
• Common Schema — Understand shared request/response fields
• Endpoints — Explore all 13 endpoints
• Solutions — Code samples in Python, C#, and JavaScript