文档

髋关节术前测量

更新时间:

本文介绍图像分析处理(imageprocess)类目下的髋关节术前测量DetectHipKeypointXRay的语法及示例。

服务说明

髋关节术前测量(DetectHipKeypointXRay)服务将于2024年4月24日起停止服务,后续不再支持新老用户开通接入及调用服务。如果您在使用过程中有疑问,可通过搜索钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

功能描述

髋关节术前测量能力可以对输入的髋关节正位片,检测到关键坐标点及其位置标签(最多21个,下图中V12不做预测)。

关于该接口功能的示例图如下:

说明
  • 您可以进入在线咨询获取在线人工帮助。
  • 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击立即试用对该能力进行更直观试用以及在线购买。
  • 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

接入指引

1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。

2. 开通能力:请确保您已开通图像分析处理,若未开通服务请立即开通

3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权

4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。

5. 开发接入步骤:

  • SDK总览中选择您要接入使用的SDK语言。
  • 在对应语言的SDK文档中找到AI类目为图像分析处理(imageprocess)的SDK包进行安装。
  • 参考文档中提供的示例代码进行适当修改后调用。

6. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

输入限制

  • 图像格式:JPEG、JPG、PNG、DCM、BMP、TIFF、HEIC。
  • 图像大小:不超过100 MB。
  • URL地址中不能包含中文字符。

计费说明

髋关节术前测量能力目前处于公测期,可免费调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action String DetectHipKeypointXRay

系统规定参数。取值:DetectHipKeypointXRay

ImageUrl String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/8%E6%9C%88%E4%BB%BD%E5%8C%BB%E7%96%97/sample_dcm_1.dcm

图像URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见文件URL处理

DataFormat String dcm

图像的格式。目前只支持以下几种:jpeg,jpg,png,dcm,bmp、tiff、heic。

OrgId String 0001

数据来源机构代码。

OrgName String weiyi

数据来源机构名称。

TracerId String 123

提供用户自定义TracerID的功能,为本次请求指定一个ID便于跟踪。

返回数据

名称

类型

示例值

描述

RequestId String 03B463B1-F306-41B5-8CD3-C65801570057

请求ID。

Data Object

返回的结果数据内容。

KeyPoints Array of KeyPoints

算法返回的结果。

Value Float 0.05762995779514313

概率值。

Coordinates Array of Integer [276,291]

点的坐标。

Tag Object

数据结构。

Direction String R

方向,L表示左,R表示右。

Label String v1

点的标签。

  • V1:髋臼最外缘
  • V2:眉弓内侧
  • V3:股骨最外侧
  • V4:股骨头中心
  • V5:股骨头最内侧
  • V6:泪滴
  • V7:股骨颈中心
  • V8:小转子上端点
  • V9:股骨骨髓近段中点
  • V10:股骨骨髓远段中点
  • V11:耻骨联合上缘
  • V12:髋臼最远点
说明
  • V9选择位置在小转子下缘髓腔中心。
  • V12的位置需要根据V1和V11连线之后才能确定。
  • V2眉弓内侧灰度由亮变暗的点。
  • V2和V12有可能会重合。
ImageUrl String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/8%E6%9C%88%E4%BB%BD%E5%8C%BB%E7%96%97/sample_dcm_1.dcm

图像URL地址,与请求参数中的ImageUrl一致。

OrgId String 0001

数据来源机构代码,与请求参数中的OrgId一致。

OrgName String weiyi

数据来源机构名称,与请求参数中的OrgName一致。

SDK参考

阿里云视觉AI图像分析处理类目下的髋关节术前测量能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为图像分析处理(imageprocess)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见SDK总览

示例

请求示例

http(s)://imageprocess.cn-shanghai.aliyuncs.com/?Action=DetectHipKeypointXRay      //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&DataFormat=dcm
&ImageUrl=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/8%E6%9C%88%E4%BB%BD%E5%8C%BB%E7%96%97/sample_dcm_1.dcm
&OrgId=0001
&OrgName=weiyi
&TracerId=123
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DetectHipKeypointXRayResponse>
    <RequestId>03B463B1-F306-41B5-8CD3-C65801570057</RequestId>
    <Data>
        <OrgId>1</OrgId>
        <KeyPoints>
            <Coordinates>7</Coordinates>
            <Coordinates>4278</Coordinates>
            <Value>0.05762995779514313</Value>
            <Tag>
                <Label>v1</Label>
                <Direction>R</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>276</Coordinates>
            <Coordinates>291</Coordinates>
            <Value>0.5291129946708679</Value>
            <Tag>
                <Label>v2</Label>
                <Direction>R</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>217</Coordinates>
            <Coordinates>499</Coordinates>
            <Value>0.19006115198135376</Value>
            <Tag>
                <Label>v3</Label>
                <Direction>R</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>388</Coordinates>
            <Coordinates>603</Coordinates>
            <Value>0.8052207231521606</Value>
            <Tag>
                <Label>v4</Label>
                <Direction>R</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>465</Coordinates>
            <Coordinates>725</Coordinates>
            <Value>0.5015578269958496</Value>
            <Tag>
                <Label>v5</Label>
                <Direction>R</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>400</Coordinates>
            <Coordinates>3957</Coordinates>
            <Value>0.5832558870315552</Value>
            <Tag>
                <Label>v6</Label>
                <Direction>R</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>264</Coordinates>
            <Coordinates>951</Coordinates>
            <Value>0.48539969325065613</Value>
            <Tag>
                <Label>v7</Label>
                <Direction>R</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>382</Coordinates>
            <Coordinates>986</Coordinates>
            <Value>0.34416449069976807</Value>
            <Tag>
                <Label>v8</Label>
                <Direction>R</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>352</Coordinates>
            <Coordinates>3018</Coordinates>
            <Value>0.6511784195899963</Value>
            <Tag>
                <Label>v9</Label>
                <Direction>R</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>346</Coordinates>
            <Coordinates>3974</Coordinates>
            <Value>0.1562270224094391</Value>
            <Tag>
                <Label>v10</Label>
                <Direction>R</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>730</Coordinates>
            <Coordinates>951</Coordinates>
            <Value>0.6610642671585083</Value>
            <Tag>
                <Label>v11</Label>
                <Direction>M</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>1167</Coordinates>
            <Coordinates>2393</Coordinates>
            <Value>0.38747161626815796</Value>
            <Tag>
                <Label>v1</Label>
                <Direction>L</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>341</Coordinates>
            <Coordinates>308</Coordinates>
            <Value>0.17997822165489197</Value>
            <Tag>
                <Label>v2</Label>
                <Direction>L</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>394</Coordinates>
            <Coordinates>3974</Coordinates>
            <Value>0.12470346689224243</Value>
            <Tag>
                <Label>v3</Label>
                <Direction>L</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>400</Coordinates>
            <Coordinates>3974</Coordinates>
            <Value>0.18173544108867645</Value>
            <Tag>
                <Label>v4</Label>
                <Direction>L</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>1227</Coordinates>
            <Coordinates>1246</Coordinates>
            <Value>0.11769253015518188</Value>
            <Tag>
                <Label>v5</Label>
                <Direction>L</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>878</Coordinates>
            <Coordinates>1159</Coordinates>
            <Value>0.3597133755683899</Value>
            <Tag>
                <Label>v6</Label>
                <Direction>L</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>1102</Coordinates>
            <Coordinates>586</Coordinates>
            <Value>0.45125287771224976</Value>
            <Tag>
                <Label>v7</Label>
                <Direction>L</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>1097</Coordinates>
            <Coordinates>986</Coordinates>
            <Value>0.17652533948421478</Value>
            <Tag>
                <Label>v8</Label>
                <Direction>L</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>1227</Coordinates>
            <Coordinates>1211</Coordinates>
            <Value>0.6892768144607544</Value>
            <Tag>
                <Label>v9</Label>
                <Direction>L</Direction>
            </Tag>
        </KeyPoints>
        <KeyPoints>
            <Coordinates>1114</Coordinates>
            <Coordinates>2132</Coordinates>
            <Value>0.21741466224193573</Value>
            <Tag>
                <Label>v10</Label>
                <Direction>L</Direction>
            </Tag>
        </KeyPoints>
        <ImageUrl>http://viapi-test.oss-cn-shanghai-internal.aliyuncs.com/test-team/xuhan/8%E6%9C%88%E4%BB%BD%E5%8C%BB%E7%96%97/sample_dcm_1.dcm</ImageUrl>
        <OrgName>weiyi</OrgName>
    </Data>
</DetectHipKeypointXRayResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "03B463B1-F306-41B5-8CD3-C65801570057",
  "Data" : {
    "OrgId" : 1,
    "KeyPoints" : [ {
      "Coordinates" : [ 7, 4278 ],
      "Value" : 0.05762995779514313,
      "Tag" : {
        "Label" : "v1",
        "Direction" : "R"
      }
    }, {
      "Coordinates" : [ 276, 291 ],
      "Value" : 0.5291129946708679,
      "Tag" : {
        "Label" : "v2",
        "Direction" : "R"
      }
    }, {
      "Coordinates" : [ 217, 499 ],
      "Value" : 0.19006115198135376,
      "Tag" : {
        "Label" : "v3",
        "Direction" : "R"
      }
    }, {
      "Coordinates" : [ 388, 603 ],
      "Value" : 0.8052207231521606,
      "Tag" : {
        "Label" : "v4",
        "Direction" : "R"
      }
    }, {
      "Coordinates" : [ 465, 725 ],
      "Value" : 0.5015578269958496,
      "Tag" : {
        "Label" : "v5",
        "Direction" : "R"
      }
    }, {
      "Coordinates" : [ 400, 3957 ],
      "Value" : 0.5832558870315552,
      "Tag" : {
        "Label" : "v6",
        "Direction" : "R"
      }
    }, {
      "Coordinates" : [ 264, 951 ],
      "Value" : 0.48539969325065613,
      "Tag" : {
        "Label" : "v7",
        "Direction" : "R"
      }
    }, {
      "Coordinates" : [ 382, 986 ],
      "Value" : 0.34416449069976807,
      "Tag" : {
        "Label" : "v8",
        "Direction" : "R"
      }
    }, {
      "Coordinates" : [ 352, 3018 ],
      "Value" : 0.6511784195899963,
      "Tag" : {
        "Label" : "v9",
        "Direction" : "R"
      }
    }, {
      "Coordinates" : [ 346, 3974 ],
      "Value" : 0.1562270224094391,
      "Tag" : {
        "Label" : "v10",
        "Direction" : "R"
      }
    }, {
      "Coordinates" : [ 730, 951 ],
      "Value" : 0.6610642671585083,
      "Tag" : {
        "Label" : "v11",
        "Direction" : "M"
      }
    }, {
      "Coordinates" : [ 1167, 2393 ],
      "Value" : 0.38747161626815796,
      "Tag" : {
        "Label" : "v1",
        "Direction" : "L"
      }
    }, {
      "Coordinates" : [ 341, 308 ],
      "Value" : 0.17997822165489197,
      "Tag" : {
        "Label" : "v2",
        "Direction" : "L"
      }
    }, {
      "Coordinates" : [ 394, 3974 ],
      "Value" : 0.12470346689224243,
      "Tag" : {
        "Label" : "v3",
        "Direction" : "L"
      }
    }, {
      "Coordinates" : [ 400, 3974 ],
      "Value" : 0.18173544108867645,
      "Tag" : {
        "Label" : "v4",
        "Direction" : "L"
      }
    }, {
      "Coordinates" : [ 1227, 1246 ],
      "Value" : 0.11769253015518188,
      "Tag" : {
        "Label" : "v5",
        "Direction" : "L"
      }
    }, {
      "Coordinates" : [ 878, 1159 ],
      "Value" : 0.3597133755683899,
      "Tag" : {
        "Label" : "v6",
        "Direction" : "L"
      }
    }, {
      "Coordinates" : [ 1102, 586 ],
      "Value" : 0.45125287771224976,
      "Tag" : {
        "Label" : "v7",
        "Direction" : "L"
      }
    }, {
      "Coordinates" : [ 1097, 986 ],
      "Value" : 0.17652533948421478,
      "Tag" : {
        "Label" : "v8",
        "Direction" : "L"
      }
    }, {
      "Coordinates" : [ 1227, 1211 ],
      "Value" : 0.6892768144607544,
      "Tag" : {
        "Label" : "v9",
        "Direction" : "L"
      }
    }, {
      "Coordinates" : [ 1114, 2132 ],
      "Value" : 0.21741466224193573,
      "Tag" : {
        "Label" : "v10",
        "Direction" : "L"
      }
    } ],
    "ImageUrl" : "http://viapi-test.oss-cn-shanghai-internal.aliyuncs.com/test-team/xuhan/8%E6%9C%88%E4%BB%BD%E5%8C%BB%E7%96%97/sample_dcm_1.dcm",
    "OrgName" : "weiyi"
  }
}

错误码

关于膝关节术前测量的错误码。详情请参见常见错误码

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。

  • 本页导读 (1)
文档反馈