本文介绍髋关节术前测量DetectHipKeypointXRay的语法及示例。

功能描述

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

前提条件

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

输入限制

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DetectHipKeypointXRay

系统规定参数。取值:DetectHipKeypointXRay。

DataFormat String dcm

图片的格式。目前只支持以下几种:jpeg,jpg,png,dcm。

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链接,如何生成URL请参见生成URL

OrgId String 0001

数据来源机构代码。

OrgName String weiyi

数据来源机构名称。

TracerId String 123

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

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

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一致。

KeyPoints Array of KeyPoints

算法返回的结果。

Coordinates List [276,291]

点的坐标。

Tag Struct

数据结构。

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有可能会重合。
Value Float 0.05762995779514313

概率值。

OrgId String 0001

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

OrgName String weiyi

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

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

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DetectHipKeypointXRay
&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 格式

<RequestId>03B463B1-F306-41B5-8CD3-C65801570057</RequestId>
<Data>
    <OrgId>0001</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>

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"
    }
}

错误码

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

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

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