Annie Insights API 入门

欢迎使用 Annie Insights API — 一套全面的人工智能驱动的牙科分析端点，可将牙科图像转化为可行的临床见解。

你能做什么

Annie Insights API 提供 13 个端点，涵盖：

类别	端点	描述
检测	临床发现、全景发现	腐烂、修复、托槽的物体检测
分割	正面、全景、咬合图（上/下）	像素级牙齿边界检测
地标检测	头颅侧位、头颅正面	169 个侧面 + 118 个正面头影测量标志
分类	颅面分类器	图像类型和方向识别
分析	颞下颌关节横截面	关节异常检测
预言	治疗长度估算器	基于机器学习的治疗持续时间预测

快速入门 - 5 分钟内首次调用 API

第 1 步：获取您的 API 密钥

请通过 api-support@hcds.ai 联系我们的团队以请求 API 密钥。为了进行测试，请使用沙箱密钥：

SANDBOX_KEY_FOR_TESTING_ONLY

沙盒限制

沙箱密钥的速率限制为 10 个请求/分钟，并返回带水印的输出图像。不要在生产中使用。

第 2 步：提出您的第一个请求

将牙科图像发送到临床结果端点：

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

第 3 步：接收结果

API 返回带有检测结果和带注释的输出图像的结构化 JSON：

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

输出图像

OutputImageUrl 是有时间限制的 Azure Blob SAS URL，有效期为 72 小时。在过期之前下载或缓存图像。有关详细信息，请参阅Output Images。

基本网址

所有 API 请求都使用以下基本 URL：

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

验证

每个请求都必须包含 x-api-key 标头。有关详细信息，请参阅Authentication。

下一步

• Authentication — 了解 API 密钥管理
• Common Schema — 了解共享请求/响应字段
• Endpoints — 探索所有 13 个端点
• Solutions — Python、C# 和 JavaScript 中的代码示例