Production Ready

ANNIE Insights API

13 AI-powered endpoints for dental diagnostics — cephalometric landmarks, clinical findings, segmentation analysis, image classification, and treatment length estimation.

Explore Endpoints → Quick Start
Why Choose Our API

Benefits for Orthodontic Workflow

Integrate AI-powered diagnostics directly into your practice management software to transform patient outcomes.

Fast Integration

Integrate any endpoint within minutes using standard REST calls. Works with any platform and any programming language.

🧠

AI-Powered Accuracy

Deep learning models trained on thousands of clinical cases deliver precise landmark detection, classification, and segmentation results.

📋

Dental Treatment Planning

Enable clinicians to create data-driven treatment plans — assess difficulty levels, estimate treatment duration, and document conditions automatically.

🕒

Save Engineering Hours

Outsource complex AI algorithm development to our proven API. No need to build and train computer vision models from scratch.

🔗

EHR/EMR Integration

Sync bidirectionally with health record systems. Structured JSON responses integrate seamlessly with digital charting and dental recordkeeping.

🔬

Research-Backed AI

Built on peer-reviewed research in quantitative deep learning and dento-craniofacial cognitive diagnosis — a proven methodology for automated clinical assessment.

Overview

All Services at a Glance

Unified API gateway — every endpoint follows the same pattern under a single domain.

🔑

Authentication Required — All API endpoints require a valid API Key. Include it in the x-api-key header with every request. To obtain your API Key, please contact our team.

🧪

Sandbox API Key — Try our API immediately with the sandbox key below. This key is rate-limited to 10 requests/minute and 2,000 requests/month for evaluation purposes.

sandbox-8da678009a7382d71c62f5eaaee567b1

Rate limit headers (X-RateLimit-Remaining-Month) are included in every response so you can track your usage.

Quick Start

Get Started in Minutes

All image-processing APIs follow the same request pattern. The TLE endpoint uses GET with query parameters.

Integration Steps

Get Your API Key

Use the sandbox key above to start testing immediately, or contact our team for a production API key.

Choose an Endpoint

Select the API matching your imaging modality — lateral ceph, panoramic, clinical photos, etc.

Send a Request

Include your key in the x-api-key header. POST a JSON body with PatientID, TimeStamp, and ImageName (URL to the image).

Receive Results

Get structured JSON with detected landmarks, findings, classifications, or segmentation data — plus an OutputImageUrl to download the annotated image. See Output Images for details.

Example — Clinical Findings

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

Example — TLE (GET)

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.annie-insights.com/api/annie-tle-v2?\
p01=1&p02=1&p03=2&p04=2&p05=2&p06=16.3&p07=1&p08=1&p09=0&p10=0&p11=1"

Base URL: https://api.annie-insights.com/api/

Request Format

Common Request Schema

All image-processing endpoints accept the same base JSON body via POST.

ParameterTypeRequiredDescription
PatientIDstringRequiredUnique patient identifier
TimeStampstringRequiredTimestamp for the analysis session
ImageNamestringRequiredFull URL to the image (e.g. https://...)

Some endpoints accept additional parameters such as PlotLabels or StandardName. See individual endpoint documentation below for details.

Output Images

Image Storage & Access

All image-producing endpoints return an OutputImageUrl — a secure, temporary link to the processed image stored in Azure Blob Storage.

📸

How OutputImageUrl Works — When an endpoint processes an image, the annotated output (with landmarks, bounding boxes, or segmentation masks) is uploaded to Azure Blob Storage. The response includes a OutputImageUrl field containing a pre-signed SAS URL for secure, read-only access.

PropertyDetail
URL FormatAzure Blob Storage SAS URL with embedded authentication token
Access TypeRead-only (sp=r) — no authentication header required to download
SAS URL Validity72 hours from generation time
Image Retention3 days — images are automatically deleted by lifecycle policy
JSON-only EndpointsClassifier, TMJ, and TLE do not return OutputImageUrl
⚠️

Important: Output images are ephemeral. Download or cache the image within 72 hours of receiving the response. After 3 days, the image is permanently deleted from storage. Do not store the SAS URL as a permanent reference.

Best Practices

⬇️

Cache Immediately

Download the output image from OutputImageUrl as soon as you receive the API response and store it in your own system.

🔄

Re-process if Needed

If the SAS URL has expired, simply re-submit the same request to the API. A fresh output and new URL will be generated.

API Reference

Endpoint Documentation

Click any endpoint to view request parameters, example payloads, and sample response.

See It In Action

How Our API Works

Watch how our AI processes dental images in real time — from identification to analysis.

Dental Structure Identification

Watch how the AI automatically identifies and categorizes dental structures from clinical images.

AI for Dental Diagnostics

See our deep learning models analyze dental radiographs and photographs for automated diagnostics.

Error Handling

Error Responses

All endpoints return structured error responses with consistent formatting.

HTTP 401 — Unauthorized

{
  "message": "No API key found in request"
}

Include a valid x-api-key header in your request.

HTTP 429 — Rate Limit Exceeded

{
  "message": "API rate limit exceeded"
}

You have exceeded your plan's request limit. Check X-RateLimit-Remaining-Month response headers to monitor usage. Contact our team to upgrade your plan.

HTTP 400 — Image Not Available

{
  "detail": {
    "PatientID": "P-001",
    "TimeStamp": "2026-05-24",
    "ImageName": "missing.jpg",
    "Error": "The specified image is not available"
  }
}

HTTP 422 — Validation Error

Returned when required fields are missing from the request body.

HTTP 500 — Internal Server Error

Returned on unexpected model or processing failures. Contact support if this persists.