用途:面向使用 Terra API Lab Reports(预发布)构建应用的开发者,提供生产实践与 API 参考。输入为单个 PDF、PNG、JPEG、GIF 或 WebP 文件,上限 20 MB;经 OCR 与 AI 解析提取结果名称、数值、单位、标记与参考区间,再以 0.85 阈值模糊匹配 4000+ 生物标志物数据集,得到规范化 biomarker key、UCUM 单位码及部分 LOINC 码。
主要能力:上传后异步处理,状态依次为 processing、processed、standardizing、standardized、sending、sent,另有 retry_scheduled、retrying、cancelled、deleted、failed;到达 standardized 即可查询结果。返回 Session 分为 Results(source、biomarker、measurement、interpretation、reference ranges 分层)与 Panels。端点包括 POST /v2/lab-reports(字段必须为 file)、GET 列表/会话/文件/投递/产物、POST reprocess、DELETE。Base URL 为 https://access.tryterra.co/api,需 dev-id 与 x-api-key 头。
使用方式:新应用可用 terra examples list --select name,title,description 与 terra examples clone lab-reports-web-app my-app 获取示例;CLI 缺失时可在 macOS/Linux 运行 curl -fsSL https://cli.tryterra.co/install.sh | sh,Windows PowerShell 运行 irm "https://cli.tryterra.co/install.ps1" | iex。命令行可用 terra data-api /lab-reports 等排查;MCP 无 terra data-api 等命令。
限制:预发布阶段契约可能变动,生成生产请求与 webhook 解析前应先抓取在线文档并验证。上传返回 upload_id 而非 session_id,一次上传可能拆分为多个会话。事件为 lab_report.completed 与 lab_report.failed,按 event_id 去重。交付细节、状态枚举、价格与平台支持等资料未完整提供,请以在线文档为准。