通用模式
所有 Annie Insights API 端点共享通用的请求参数和响应模式。
标准请求参数
每个基于图像的端点都需要这三个参数：
| 范围 | 类型 | 必需的 | 描述 |
|---|---|---|---|
PatientID | 细绳 | ✅ 是的 | 您系统中的唯一患者标识符 |
TimeStamp | 细绳 | ✅ 是的 | 分析会话时间戳（例如“2026-05-24”） |
ImageName | 细绳 | ✅ 是的 | 要分析的牙科图像的完整 URL |
请求正文示例
{
"PatientID": "P-001",
"TimeStamp": "2026-05-24",
"ImageName": "https://your-storage.com/images/patient-photo.jpg"
}
图片 URL 要求
- 必须是可公开访问的 HTTPS URL
- 支持的格式：JPEG、PNG
- 最大文件大小：20MB
- 建议分辨率：1024×768或更高
标准响应字段
| 场地 | 类型 | 描述 |
|---|---|---|
Version | 细绳 | 用于处理的API版本 |
PatientID | 细绳 | 从请求中得到回应 |
TimeStamp | 细绳 | 从请求中得到回应 |
ImageName | 细绳 | 处理后的图像文件名 |
Results | 目的 | 特定端点的分析结果 |
OutputImageUrl | 细绳 | 带注释的图像 URL（受 SAS 保护，72 小时到期） |
可选参数
一些端点接受额外的可选参数：
| 范围 | 类型 | 可用日期 | 描述 |
|---|---|---|---|
StandardName | 细绳 | 正面分割 | 评价标准（默认："ICON"） |
PlotLabels | 布尔值 | 正面分割 | 在输出上显示分类标签 |
DrawContours | 布尔值 | 分段端点 | 在输出上绘制轮廓轮廓 |