Amazon Comprehend Medical
Amazon Comprehend Medical 的透傳端點 - 以原生 AWS 格式(不進行翻譯)在臨床文字中偵測實體、PHI,以及醫療本體連結。
| 功能 | 支援 | 備註 |
|---|---|---|
| 成本追蹤 | ✅ | 適用於下列同步文字操作 |
| 記錄 | ✅ | 可在所有整合中運作 |
| 終端使用者追蹤 | ❌ | 如果您需要這項功能,請告訴我們 |
| 串流 | ❌ | Comprehend Medical API 不提供 |
只要將 https://comprehendmedical.{aws_region_name}.amazonaws.com 替換為 LITELLM_PROXY_BASE_URL/comprehendmedical 即可 🚀
LiteLLM 會使用代理程式的 AWS 憑證,透過 SigV4 對轉送的請求簽章,因此用戶端只需要一組 LiteLLM 虛擬金鑰。
快速開始
- 在代理環境中設定 AWS 憑證與區域
export AWS_ACCESS_KEY_ID=""
export AWS_SECRET_ACCESS_KEY=""
export AWS_REGION_NAME="us-east-1"
- 啟動代理
litellm
# RUNNING on http://0.0.0.0:4000
- 透過代理呼叫 Comprehend Medical 操作
curl -X POST 'http://0.0.0.0:4000/comprehendmedical/DetectEntitiesV2' \
-H "Authorization: Bearer $LITELLM_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"Text": "Patient is taking 40mg of atorvastatin daily for hyperlipidemia."}'
URL 中的操作名稱必須是受支援的同步文字操作之一:DetectEntitiesV2、DetectPHI、InferICD10CM、InferRxNorm,或 InferSNOMEDCT。其他操作(例如非同步批次作業 API)會回傳 400,並列出受支援的集合。查看所有 Comprehend Medical 操作
與 AWS SDK(boto3)一起使用
將 SDK 的 endpoint_url 指向 LITELLM_PROXY_BASE_URL/comprehendmedical。代理會依據 AWS JSON 1.1 通訊協定,從 SDK 的 X-Amz-Target 標頭讀取操作。
import boto3
client = boto3.client(
"comprehendmedical",
region_name="us-east-1",
endpoint_url="http://0.0.0.0:4000/comprehendmedical",
aws_access_key_id="placeholder",
aws_secret_access_key="placeholder",
)
client.meta.events.register(
"before-send.comprehendmedical.*",
lambda request, **kwargs: request.headers.__setitem__("x-litellm-api-key", "sk-<your-litellm-api-key>"),
)
response = client.detect_phi(Text="John Smith was admitted on 2026-08-01.")
print(response["Entities"])
SDK 仍會使用預留的憑證在本機對請求簽章,但 LiteLLM 會捨棄該簽章,使用 x-litellm-api-key 標頭中的 LiteLLM 虛擬金鑰驗證呼叫,並以代理的 AWS 憑證重新為請求簽章。
成本追蹤
支出是根據請求的 Text 長度計算:Comprehend Medical 依每個已開始的 100 字元單位計費,最低為 1 個單位。LiteLLM 會針對每個操作套用第一級隨選價格/單位:
| 操作 | 每單位價格 |
|---|---|
DetectEntitiesV2 | $0.01 |
DetectPHI | $0.0014 |
InferICD10CM | $0.0005 |
InferRxNorm | $0.00025 |
InferSNOMEDCT | $0.0075 |
請求會以模型 comprehendmedical/{Operation} 與提供者 comprehendmedical 記錄,而支出會顯示在一般位置(SpendLogs、金鑰/團隊預算、記錄整合)。此表以外的操作會被 400 拒絕,因此沒有任何 Comprehend Medical 呼叫能繞過支出追蹤。