出力画像
ほとんどの API エンドポイントは、OutputImageUrl (AI 分析結果が視覚的にオーバーレイされた入力画像の注釈付きバージョン) を返します。
仕組み
- API 経由で歯科画像の URL を送信します
- Annie Insights AI が画像を処理して注釈を付ける
- API は、注釈付きの結果をダウンロードするための時間制限のある Azure Blob SAS URL を返します
SAS URL の動作
| 財産 | 価値 |
|---|---|
| ストレージ | Azure Blob ストレージ |
| URL の有効性 | 72 時間 (本番)、24 時間 (サンドボックス) |
| 自動削除 | 出力画像は3日後に削除されます |
| アクセス | 読み取り専用 (sp=r) |
期間限定アクセス
API 応答を受信した後、ただちに、出力画像をダウンロードまたはキャッシュします。 SAS URL の有効期限が切れ、イメージは 3 日後に完全に削除されます。
URLの例
https://annieapistorage.blob.core.windows.net/api-output-images/clinical-images/a1b2c3d4.jpg?se=2026-05-27&sp=r&sv=2021-08-06&sr=b&sig=...
ベストプラクティス
- すぐにダウンロード — 後で利用できる URL に依存しないでください。
- ローカルに保存 — 出力画像を独自のストレージ システムに保存します
- 結果をキャッシュ — 完全な API 応答 JSON を画像と一緒に保存します
- 有効期限の処理 — URL の有効期限が切れた場合、再分析のために元の画像を再送信します。