查询模型的默认配置
更新时间:2026-11-04
接口描述
查询一个模型的默认配置和最低硬件要求。defaultModelConfig 可以直接作为创建请求的 modelConfig。
权限说明
具备百舸(AIHC)的任一权限即可。
请求结构
Plain Text
1GET /?action=DescribeEmbodiedEvalModel&modelName={modelName}
2Host: aihc.bj.baidubce.com
3Authorization: {authorization}
4version: v2
请求头域
除公共头域外,无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 说明 |
|---|---|---|---|---|
modelName |
String | 是 | Query参数 | 模型名称,取自 DescribeEmbodiedEvalModels |
响应头域
除公共头域外,无其它特殊头域。
响应参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
requestId |
String | 请求 ID |
modelName / displayName |
String | 模型名称、展示名称 |
minHardware |
MinHardware | 模型服务单副本的最低硬件要求 |
defaultModelConfig |
ModelConfig | 推荐的模型服务配置 |
extraArgsSchema |
ParamSchema | benchmarkConfigs[].modelOverride.extraArgs 可以填的参数 |
chunkSizeLimit |
Integer | modelOverride.chunkSize 的建议上限 |
maxBatchSizeLimit |
Integer | modelConfig.maxBatchSize 的建议上限 |
请求示例
Bash
1python3 call_eval.py GET DescribeEmbodiedEvalModel modelName=openvla_7b
响应示例
JSON
1{
2 "requestId": "91a2b3c4-d5e6-4f78-a19c-0d1e2f3a4b5c",
3 "modelName": "openvla_7b",
4 "displayName": "OpenVLA",
5 "minHardware": {
6 "acceleratorTypes": ["baidu.com/l20_cgpu", "baidu.com/rtx_4090_cgpu", "baidu.com/a10_24g_cgpu", "baidu.com/a800_80g_cgpu"],
7 "acceleratorCount": 1,
8 "cpu": 4,
9 "memory": 16
10 },
11 "defaultModelConfig": {
12 "modelType": "public",
13 "modelName": "openvla_7b",
14 "replicas": 1,
15 "maxBatchSize": 1,
16 "resources": [
17 {"name": "baidu.com/l20_cgpu", "quantity": 1},
18 {"name": "cpu", "quantity": 8},
19 {"name": "memory", "quantity": 32}
20 ]
21 },
22 "extraArgsSchema": {
23 "requiredArgs": ["unnorm_key"],
24 "optionalArgs": ["unnorm_key", "jpeg_roundtrip", "center_crop", "action_ensemble"],
25 "properties": {
26 "unnorm_key": {"type": "string", "default": null, "nullable": true, "enum": ["libero_spatial", "libero_object", "libero_goal", "libero_10", "bridge_orig"], "description": "动作反归一化使用哪一组训练集统计量"},
27 "jpeg_roundtrip": {"type": "boolean", "default": false, "description": "模拟 OpenVLA 官方评测的 JPEG 预处理"},
28 "center_crop": {"type": "boolean", "default": false, "description": "模拟 OpenVLA 官方评测的中心裁剪预处理"},
29 "action_ensemble": {"type": "string", "default": "newest", "enum": ["newest", "average", "ema"], "description": "动作 chunk 跨步重叠时的融合策略"}
30 }
31 },
32 "chunkSizeLimit": 8,
33 "maxBatchSizeLimit": 1
34}
注意事项
defaultModelConfig.resources里的卡型只是示例,要换成自己队列里的卡型,且必须在minHardware.acceleratorTypes里。chunkSizeLimit、maxBatchSizeLimit是建议值,超过时创建不会报错,但可能导致显存不足或结果异常。
错误码
| HTTP 状态码 | code | 场景 |
|---|---|---|
| 400 | InvalidParameter |
没有传 modelName |
| 404 | NotFound |
模型不存在 |
评价此篇文章
