API 参考文档#
MAISI NIM 提供以下 API 端点
GET
: /v1/health/live - 检查服务是否存活(可能尚未准备就绪)GET
: /v1/health/ready - 检查服务是否准备就绪以及模型是否可以进行推理GET
: /v1/license - 返回 NIM 的许可证GET
: /v1/maisi/info - 获取关于模型的详细信息,例如版本和标签POST
: /v1/maisi/run - 生成带有配对分割掩码的 CT 图像
Payload 选项#
参数 |
必需 |
类型 |
描述 |
选项/范围 |
---|---|---|---|---|
|
是 |
整数 |
要生成的图像数量 |
正整数 |
|
是 |
字符串列表 |
目标身体区域 |
[“head”, “chest”, “thorax”, “abdomen”, “pelvis”, “lower”] |
|
否 |
字符串列表 |
特定的解剖结构 |
请参阅“支持的解剖结构”部分 |
|
否 |
包含 3 个整数的列表 |
图像尺寸 (x, y, z) |
x, y: 256, 384, 512 |
|
否 |
包含 3 个浮点数的列表 |
体素间距 |
每个值:0.5 到 5.0 |
|
否 |
元组列表(字符串,浮点数),用于器官名称和大小 |
器官大小控制(最多 10 个) |
Organs: [“liver”, “gallbladder”, “stomach”, “pancreas”, “colon”, “lung tumor”, “bone lesion”, “hepatic tumor”, “colon cancer primaries”, “pancreatic tumor”] |
|
否 |
字符串 |
用于结果上传的 URL |
- |
|
否 |
字符串 |
如果指定,生成的图像将保存在提供的目录中。 |
- |
|
否 |
字符串 |
输出文件扩展名 |
支持的扩展名:“.nrrd”, “.nii”, “.nii.gz”, “.dcm”。默认值:“.nii.gz” |
|
否 |
字符串 |
输出文件扩展名 |
支持的扩展名:“.nrrd”, “.nii”, “.nii.gz”, “.dcm”。默认值:“.nii.gz” |
支持的解剖结构#
您可以在 MAISI label_dict.json 中找到模型中所有可用的类别。
推荐的 output_size
和 spacing
值#
根据训练数据的统计信息,我们为训练数据中包含的身体区域推荐以下输入参数。推荐的 output_size
是训练数据的中位数,推荐的 spacing
计算为中位数视野 (FOV) 除以推荐的 output_size
。
|
|
|
---|---|---|
[‘chest’, ‘abdomen’] |
[512, 512, 128] |
[0.781, 0.781, 2.981] |
[‘chest’] |
[512, 512, 128] |
[0.684, 0.684, 2.422] |
[‘chest’, ‘abdomen’, ‘lower’] |
[512, 512, 256] |
[0.793, 0.793, 1.826] |
[‘lower’] |
[512, 512, 384] |
[0.839, 0.839, 0.728] |
[‘abdomen’, ‘lower’] |
[512, 512, 384] |
[0.808, 0.808, 0.729] |
[‘head’, ‘chest’, ‘abdomen’] |
[512, 512, 384] |
[0.977, 0.977, 2.103] |
[‘abdomen’] |
[512, 512, 128] |
[0.723, 0.723, 1.182] |
[‘head’, ‘chest’, ‘abdomen’, ‘lower’] |
[512, 512, 384] |
[1.367, 1.367, 4.603] |
[‘head’, ‘chest’] |
[512, 512, 128] |
[0.645, 0.645, 2.219] |
如果用户想要尝试不同的 "output_size"
,请调整 "spacing"
以确保合理的 FOV,FOV 是 "output_size"
和 "spacing"
的乘积。
有关更多示例,请参阅入门指南。