Introdução à API Annie Insights

Bem-vindo à Annie Insights API — um conjunto abrangente de endpoints de análise odontológica alimentados por IA que transformam imagens dentárias em insights clínicos acionáveis.

O que você pode fazer

A API Annie Insights fornece 13 endpoints cobrindo:

Categoria	Pontos finais	Descrição
Detecção	Achados Clínicos, Achados Panorâmicos	Detecção de objetos para deterioração, restaurações, braquetes
Segmentação	Frontal, Panorâmico, Oclusograma (Superior/Inferior)	Detecção de limite de dente em nível de pixel
Detecção de pontos de referência	Cefaléia Lateral, Cefaléia Frontal	169 marcos cefalométricos laterais + 118 frontais
Classificação	Classificador Craniofacial	Tipo de imagem e reconhecimento de orientação
Análise	Transversal da ATM	Detecção de anomalias articulares
Previsão	Estimador de duração do tratamento	Previsão de duração do tratamento baseada em ML

Início rápido — Primeira chamada de API em 5 minutos

Etapa 1: obtenha sua chave de API

Entre em contato com nossa equipe em api-support@hcds.ai para solicitar uma chave de API. Para teste, use a chave sandbox:

SANDBOX_KEY_FOR_TESTING_ONLY

Limitações da área restrita

A chave do sandbox tem um limite de taxa de 10 solicitações/minuto e retorna imagens de saída com marca d’água. Não use na produção.

Etapa 2: faça sua primeira solicitação

Envie uma imagem dentária para o endpoint Clinical Findings:

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

Etapa 3: receber resultados

A API retorna JSON estruturado com resultados de detecção e uma imagem de saída 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/..."
}

Imagens de saída

O OutputImageUrl é um URL SAS de Blob do Azure com limite de tempo válido por 72 horas. Baixe ou armazene em cache a imagem antes de expirar. Consulte Output Images para obter detalhes.

URL base

Todas as solicitações de API usam o seguinte URL base:

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

Autenticação

Cada solicitação deve incluir um cabeçalho x-api-key. Consulte Authentication para obter detalhes.

Próximas etapas

• Autenticação — Saiba mais sobre o gerenciamento de chaves de API
• Esquema comum — Entenda os campos de solicitação/resposta compartilhados
• Endpoints — Explore todos os 13 endpoints
• Soluções — Exemplos de código em Python, C# e JavaScript