Primeros pasos con la API Annie Insights

Bienvenido a Annie Insights API: un conjunto completo de puntos finales de análisis dental impulsados ​​por IA que transforman imágenes dentales en conocimientos clínicos procesables.

Qué puedes hacer

La API Annie Insights proporciona 13 puntos finales que cubren:

Categoría	Puntos finales	Descripción
Detección	Hallazgos clínicos, hallazgos panorámicos	Detección de objetos para caries, restauraciones, brackets.
Segmentación	Frontal, Panorámico, Oclusograma (Superior/Inferior)	Detección de límites de dientes a nivel de píxeles
Detección de puntos de referencia	Ceph lateral, Ceph frontal	169 puntos de referencia cefalométricos laterales + 118 frontales
Clasificación	Clasificador craneofacial	Reconocimiento de orientación y tipo de imagen
Análisis	ATM transversal	Detección de anomalías articulares.
Predicción	Estimador de duración del tratamiento	Predicción de la duración del tratamiento basada en ML

Inicio rápido: primera llamada API en 5 minutos

Paso 1: obtenga su clave API

Póngase en contacto con nuestro equipo en api-support@hcds.ai para solicitar una clave API. Para realizar pruebas, utilice la clave de la zona de pruebas:

SANDBOX_KEY_FOR_TESTING_ONLY

Limitaciones de la zona de pruebas

La clave de la zona de pruebas tiene un límite de velocidad de 10 solicitudes/minuto y devuelve imágenes de salida con marcas de agua. No utilizar en producción.

Paso 2: haga su primera solicitud

Envíe una imagen dental al punto final de hallazgos clínicos:

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"
  }'

Paso 3: reciba los resultados

La API devuelve JSON estructurado con resultados de detección y una imagen de salida anotada:

{
  "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/..."
}

Imágenes de salida

OutputImageUrl es una dirección URL de Azure Blob SAS de tiempo limitado válida durante 72 horas. Descargue o almacene en caché la imagen antes de que caduque. Consulte Output Images para obtener más detalles.

URL base

Todas las solicitudes de API utilizan la siguiente URL base:

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

Autenticación

Cada solicitud debe incluir un encabezado x-api-key. Consulte Authentication para obtener más detalles.

Próximos pasos

• Autenticación: obtenga más información sobre la administración de claves API
• Esquema común: comprender los campos de solicitud/respuesta compartidos
• Puntos finales: explore los 13 puntos finales
• Soluciones: ejemplos de código en Python, C# y JavaScript