响应示例 状态码：200 { "url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/scenarios/32050/", "id": 32050, "created_at": 1742353268.604604, "updated_at": 1742353269.253803, "labels": [ ], "gen_scenario": null, "road_scenario": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/road-scenarios/865/", "description": { "content": "" }, "file": { "url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/scenarios/32050/files/d3f8b502c334296765xxxxxxxx951ff42a02b71eaeb7ebd118e2898/", "sha256": "d3f8b502c334296765xxxxxxxx951ff42a02b71eaeb7ebd118e2898", "created_at": 1742353268.593741, "updated_at": 1742353269.144296, "path": "sim/ifiles/scenario/d3f8b502c334296765xxxxxxxx951ff42a02b71eaeb7ebd118e2898.xosc", "bucket": "octopus-raw-54d37c8f25af42xxxxx4ee9772687bf", "filename": "scenario_1742353244.xosc", "ready": true }, "map": { "url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/maps/21668/", "id": 21668, "created_at": 1742353260.93824, "updated_at": 1744074022.312378, "file": { "url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/maps/21668/files/15f9598b9e4a2677xxxxxxxxa7f0ed31f98da0954b0ab4171c7ec203/", "sha256": "15f9598b9e4a2677xxxxxxxxa7f0ed31f98da0954b0ab4171c7ec203", "created_at": 1742353260.934919, "updated_at": 1742353261.36653, "path": "sim/ifiles/map/15f9598b9e4a2677xxxxxxxxa7f0ed31f98da0954b0ab4171c7ec203.xodr", "bucket": "octopus-raw-54d37c8f25af42xxxxx4ee9772687bf", "filename": "road.xodr", "ready": true }, "version": "v1.5.0", "agreement_confirm": true }, "model": null, "simulator": "B", "version": "v0.9.1", "filename": "scenario_174xxx244.xosc", "map_filename": "road.xodr", "model_filename": null, "user_id": "5ffa2cb7631340xxxxx4736284af7dc4", "user_name": "octopus_admin", "source": "UPLOAD", "name": "sc_7BgqxxxxuKCKwYw", "priority": 60, "status": 0 }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 url String 场景资源地址 id Integer 场景ID created_at TimeStamp 创建时间 updated_at TimeStamp 更新时间 labels Array of LabelBriefSrlz objects 场景标签。场景标签体系为树状结构，按照OpenLABEL标准进行设计 gen_scenario String 泛化场景资源地址 road_scenario String 路采场景资源地址 description description object 描述 file FileNestedSrlz object 场景文件信息 map map object 场景地图信息 model model object 场景模型信息 simulator String 仿真器，如：B version String 场景对应的OpenSCENARIO版本 filename String 场景文件名称 map_filename String 场景地图文件名称 model_filename String 场景模型文件名称 user_id String 用户ID user_name String 用户名称 name String 场景名称 priority Integer 优先级,取值越大，优先级越高。可从如下范围中选择： 120 – S：至关重要 100 – A：很重要 80 – B：重要 60 – C：普通 status Integer 状态信息： 0 - Released 已发布 1 - Available 可用 10 - Initial 初始化中 11 - Unavailable 不可用 12 - Releasing 发布中 100 - Deprecated 已弃用 source String 来源，如 UPLOAD - 用户上传 表4 LabelBriefSrlz 参数 参数类型 描述 name String 场景标签名称 url String 场景标签资源地址 id Integer 场景标签ID family Integer 0 - Customized 1 - Odd China 2 - Open Odd 3 - Odd Nhtsa 4 - Open Label root Long 场景标签所在标签树的根标签ID tag_type String 场景标签所属标签树名称 parent_names Array of objects 父标签名称 表5 description 参数 参数类型 描述 content String 描述的内容 表6 map 参数 参数类型 描述 url String 地图资源地址 id Integer 地图ID created_at TimeStamp 创建时间 updated_at TimeStamp 更新时间 file FileNestedSrlz object 地图文件信息 version String 地图版本 v1.4.0 - v1.4.0 v1.5.0 - v1.5.0 v1.6.0 - v1.6.0 v1.6.1 - v1.6.1 v1.7.0 - v1.7.0 agreement_confirm Boolean 协议确认 true - 同意 false - 不同意 表7 model 参数 参数类型 描述 url String 模型资源地址 id Integer 模型ID created_at TimeStamp 创建时间 updated_at TimeStamp 更新时间 file FileNestedSrlz object 模型文件信息 format String 模型文件格式 osgb - osgb fbx - fbx agreement_confirm Boolean 协议确认 true - 同意 false - 不同意 表8 FileNestedSrlz 参数 参数类型 描述 url String 文件资源地址 sha256 String 文件SHA256 信息 created_at Double 创建时间 updated_at Double 更新时间 path String 文件路径信息 bucket String bucket信息 filename String 文件名称 ready Boolean 文件状态。完成文件上传状态为true，未完成文件上传状态为false

响应示例 状态码：200 { "url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/scenarios/32050/", "id": 32050, "created_at": 1742353268.604604, "updated_at": 1742353269.253803, "labels": [ ], "gen_scenario": null, "road_scenario": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/road-scenarios/865/", "description": { "content": "" }, "file": { "url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/scenarios/32050/files/d3f8b502c334296765xxxxxxxx951ff42a02b71eaeb7ebd118e2898/", "sha256": "d3f8b502c334296765xxxxxxxx951ff42a02b71eaeb7ebd118e2898", "created_at": 1742353268.593741, "updated_at": 1742353269.144296, "path": "sim/ifiles/scenario/d3f8b502c334296765xxxxxxxx951ff42a02b71eaeb7ebd118e2898.xosc", "bucket": "octopus-raw-54d37c8f25af42xxxxx4ee9772687bf", "filename": "scenario_1742353244.xosc", "ready": true }, "map": { "url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/maps/21668/", "id": 21668, "created_at": 1742353260.93824, "updated_at": 1744074022.312378, "file": { "url": "/v2/54d37c8f25af42xxxxx4ee9772687bf/sim/sm/maps/21668/files/15f9598b9e4a2677xxxxxxxxa7f0ed31f98da0954b0ab4171c7ec203/", "sha256": "15f9598b9e4a2677xxxxxxxxa7f0ed31f98da0954b0ab4171c7ec203", "created_at": 1742353260.934919, "updated_at": 1742353261.36653, "path": "sim/ifiles/map/15f9598b9e4a2677xxxxxxxxa7f0ed31f98da0954b0ab4171c7ec203.xodr", "bucket": "octopus-raw-54d37c8f25af42xxxxx4ee9772687bf", "filename": "road.xodr", "ready": true }, "version": "v1.5.0", "agreement_confirm": true }, "model": null, "simulator": "SimPro", "version": "v0.9.1", "filename": "scenario_174xxx244.xosc", "map_filename": "road.xodr", "model_filename": null, "user_id": "5ffa2cb7631340xxxxx4736284af7dc4", "user_name": "octopus_admin", "source": "UPLOAD", "name": "sc_7BgqxxxxuKCKwYw", "priority": 60, "status": 0 }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 url String 场景资源地址 id Integer 场景ID created_at TimeStamp 创建时间 updated_at TimeStamp 更新时间 labels Array of LabelBriefSrlz objects 场景标签。场景标签体系为树状结构，按照OpenLABEL标准进行设计 gen_scenario String 泛化场景资源地址 road_scenario String 路采场景资源地址 description description object 描述 file FileNestedSrlz object 场景文件信息 map map object 场景地图信息 model model object 场景模型信息 simulator String 仿真器，如 SimPro version String 场景对应的OpenSCENARIO版本 filename String 场景文件名称 map_filename String 场景地图文件名称 model_filename String 场景模型文件名称 user_id String 用户ID user_name String 用户名称 name String 场景名称 priority Integer 优先级,取值越大，优先级越高。可从如下范围中选择： 120 – S：至关重要 100 – A：很重要 80 – B：重要 60 – C：普通 status Integer 状态信息： 0 - Released 已发布 1 - Available 可用 10 - Initial 初始化中 11 - Unavailable 不可用 12 - Releasing 发布中 100 - Deprecated 已弃用 source String 来源，如 UPLOAD - 用户上传 表4 LabelBriefSrlz 参数 参数类型 描述 name String 场景标签名称 url String 场景标签资源地址 id Integer 场景标签ID family Integer 0 - Customized 1 - Odd China 2 - Open Odd 3 - Odd Nhtsa 4 - Open Label root Long 场景标签所在标签树的根标签ID tag_type String 场景标签所属标签树名称 parent_names Array of objects 父标签名称 表5 description 参数 参数类型 描述 content String 描述的内容 表6 map 参数 参数类型 描述 url String 地图资源地址 id Integer 地图ID created_at TimeStamp 创建时间 updated_at TimeStamp 更新时间 file FileNestedSrlz object 地图文件信息 version String 地图版本 v1.4.0 - v1.4.0 v1.5.0 - v1.5.0 v1.6.0 - v1.6.0 v1.6.1 - v1.6.1 v1.7.0 - v1.7.0 agreement_confirm Boolean 协议确认 true - 同意 false - 不同意 表7 model 参数 参数类型 描述 url String 模型资源地址 id Integer 模型ID created_at TimeStamp 创建时间 updated_at TimeStamp 更新时间 file FileNestedSrlz object 模型文件信息 format String 模型文件格式 osgb - osgb fbx - fbx agreement_confirm Boolean 协议确认 true - 同意 false - 不同意 表8 FileNestedSrlz 参数 参数类型 描述 url String 文件资源地址 sha256 String 文件SHA256 信息 created_at Double 创建时间 updated_at Double 更新时间 filename String 文件名称 ready Boolean 文件状态。完成文件上传状态为true，未完成文件上传状态为false

请求示例 创建仿真场景 POST https://{endpoint}/v2/{project_id}/sim/sm/scenarios/ { "name" : "my-scenario", "simulator" : "my-simulator", "priority" : 40, "description" : { "content" : "scenario description" }, "version" : "v1.1.1", "map" : "/v2/my_projectid/sim/sm/maps/2631662/", "map_filename" : "ALKS_Road_straight.xodr", "source" : "UPLOAD" }

响应示例 状态码：201 请求成功 { "url" : "/v2/my_project_id/sim/sm/scenarios/361/", "id" : 361, "created_at" : 1.699954029362022E9, "updated_at" : 1.699954029362044E9, "labels" : [ ], "gen_scenario" : null, "road_scenario" : null, "description" : { "content" : "scenario description" }, "file" : null, "simulator" : "my-simulator", "version" : "v1.1.1", "map_filename" : "ALKS_Road_straight.xodr", "model_filename" : null, "user_id" : "userId", "user_name" : "userName", "name" : "my-scenario", "priority" : 40, "map" : "/v2/my_project_id/sim/sm/maps/2631662/", "model" : null, "source" : "UPLOAD" }

响应参数 状态码：201 表5 响应Body参数 参数 参数类型 描述 url String 仿真场景的资源地址。 id Integer 仿真场景ID。 created_at Double 创建时间。 updated_at Double 更新时间。 labels Array of LabelBriefSrlz objects 场景所关联的标签。场景标签体系为树状结构，按照OpenLABEL标准进行设计。 gen_scenario String 泛化场景资源地址。通过该字段判断仿真场景是否由泛化场景导入，并关联到导入的泛化场景。 road_scenario String 路采场景资源地址。通过该字段判断仿真场景是否由路采场景导入，并关联到导入的路采场景。 description MutableFileSrlz object 描述的内容。 file file object 仿真场景文件，场景文件为OpenSCENARIO格式。 simulator String 仿真器，支持VTD和SimPro。 version String 场景对应的OpenSCENARIO版本。 map_filename String 地图文件名称，地图文件为OpenDRIVE格式。 model_filename String 地图文件所关联的3D模型文件名称，当前支持OSGB格式。 user_id String 用户id。 user_name String 用户名。 name String 场景名称。 priority Integer 120 - S 100 - A 80 - B 60 - C 40 - D map String 场景地图资源地址。 model String 场景3D模型资源地址。 source String UPLOAD - User upload scenario. ROAD - Road scenario. GENERALIZATION - Generalized scenario. BUILT_IN - Built-in scenario. 表6 LabelBriefSrlz 参数 参数类型 描述 name String 场景标签名称。 url String 场景标签资源地址。 id Integer 场景标签ID。 family Integer 0 - Customized 1 - Odd China 2 - Open Odd 3 - Odd Nhtsa 4 - Open Label root Long 场景标签所在标签树的根标签ID。 tag_type String 场景标签所属标签树名称。 parent_names Array of objects 父标签名称。 表7 MutableFileSrlz 参数 参数类型 描述 content String 描述的内容。 表8 file 参数 参数类型 描述 url String 文件资源地址。 sha256 String 文件sha256值。 created_at Double 创建时间。 updated_at Double 更新时间。 post post object POST预签链接信息，用于上传文件。 put_url String PUT预签链接地址，用于上传文件。优先使用POST方法上传。 get_url String GET地址，用于下载文件。 expire Integer 默认失效时间为600秒。 ready Boolean 文件状态。完成文件上传状态为true，未完成文件上传状态为false。 filename String 文件名。 表9 post 参数 参数类型 描述 url String POST预签链接信息，用于上传文件。 fields PostResponseField object POST预签链接信息，调用POST预签链接上传文件时用于构造请求。 表10 PostResponseField 参数 参数类型 描述 key String Post预签链接Key字段，在创建请求时需要添加到请求头。 x-amz-algorithm String Post预签链接x-amz-algorithm字段，在创建请求时需要添加到请求头。 x-amz-credential String Post预签链接x-amz-credential字段，在创建请求时需要添加到请求头。 x-amz-date String Post预签链接x-amz-date字段，在创建请求时需要添加到请求头。 policy String Post预签链接policy字段，在创建请求时需要添加到请求头。 x-amz-signature String Post预签链接x-amz-signature字段，在创建请求时需要添加到请求头。

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 gen_scenario 否 String 泛化场景资源地址。通过该字段判断仿真场景是否由泛化场景导入，并关联到导入的泛化场景。 description 是 MutableFileSrlz object 描述的内容。 file 否 file object 仿真场景文件，场景文件为OpenSCENARIO格式。 simulator 是 String 仿真器，支持VTD和SimPro。 version 是 String 场景对应的OpenSCENARIO版本。 map_filename 否 String 地图文件名称，地图文件为OpenDRIVE格式。 model_filename 否 String 地图文件所关联的3D模型文件名称，当前支持OSGB格式。 user_id 否 String 用户id。 user_name 否 String 用户名。 name 是 String 场景名称。 priority 否 Integer 120 - S 100 - A 80 - B 60 - C 40 - D map 否 String 场景地图资源地址。 model 否 String 场景3D模型资源地址。 source 否 String UPLOAD - User upload scenario. ROAD - Road scenario. GENERALIZATION - Generalized scenario. BUILT_IN - Built-in scenario. 表3 MutableFileSrlz 参数 是否必选 参数类型 描述 content 是 String 描述的内容。 表4 file 参数 是否必选 参数类型 描述 sha256 是 String 文件sha256值。 filename 是 String 文件名。