Annie Insights API の使用を開始する
Annie Insights API へようこそ。これは、歯科画像を実用的な臨床洞察に変換する、AI を活用した歯科分析エンドポイントの包括的なスイートです。
あなたにできること
Annie Insights API は、以下をカバーする 13 のエンドポイントを提供します。
| カテゴリ | エンドポイント | 説明 |
|---|---|---|
| 検出 | 臨床所見、パノラマ所見 | 腐敗、修復物、ブラケットの物体検出 |
| セグメンテーション | 正面、パノラマ、咬合図（上部/下部） | ピクセルレベルの歯の境界検出 |
| ランドマークの検出 | 側面セフ、正面セフ | 側面 169 個 + 正面 118 個の頭部計測ランドマーク |
| 分類 | 頭蓋顔面分類子 | 画像の種類と方向の認識 |
| 分析 | 顎関節の断面図 | 関節異常検出 |
| 予測 | 治療期間の推定ツール | ML に基づいた治療期間の予測 |
クイック スタート — 5 分で最初の API 呼び出し
ステップ 1: API キーを取得する
API キーをリクエストするには、api-support@hcds.ai のチームにお問い合わせください。テストには、サンドボックス キーを使用します。
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 は、72 時間有効な時間制限のある Azure Blob SAS URL です。有効期限が切れる前にイメージをダウンロードまたはキャッシュします。詳細については、Output Images を参照してください。
ベースURL
すべての API リクエストは次のベース URL を使用します。
https://api.annie-insights.com/api/v2
認証
すべてのリクエストには x-api-key ヘッダーが含まれている必要があります。詳細については、Authentication を参照してください。