更新时间：2025-09-24 GMT+08:00
图片标注数据集文件说明
OCTOPUS格式文件基本要求（图片标注）
上传的OCTOPUS格式数据集需包含以下文件。
├─ 时间戳1
├─时间戳1.jpg #时间戳1对应的已标注图片
├─时间戳1.json #时间戳1内该标注图片的所有标注信息
├─ 时间戳2
├─时间戳2.jpg #时间戳2对应的已标注图片
├─时间戳2.json #时间戳2内该标注图片的所有标注信息
标注数据.json文件说明
数据集中必含“.json”文件，用于集合该时间戳已标注图片的所有标注数据信息，包括该图片所在的项目id、数据包id、图片上所有标注框信息等。上传数据集前请保证“.json”文件内容正确。“.json”文件编写的参考样例如下：
{
"frame_id" : 1,
#帧序号
"batch_task_id" : 922,
#批次任务ID
"project_id" : "ca.....",
#资源域ID
"label_mode" : "manual",
#标注类型：auto和manual两种
"status" : "labeled",
#标注任务状态：unlabeled、labeled、unconfirmed、confirmed、all五种
"sample_type" : "IMAGE",
#样本类型：包含“IMAGE”、“POINT_CLOUD” 、“AUDIO”（音频）、“TEXT”（文本）
、“IMAGE_CAPTION”（图片） 、“IMAGE_QA”（图片QA对）
"des_order" : "",
#此份数据对应的原始数据包描述
"tag_names" : [],
#标签名称
"valid" : true,
#是否有效，包含“true”和“false”两种
"create_time" : 1683185878405,
#标注的创建时间
"difficult" : false,
#是否难例，包含“true”难例和“false”非难例
"label_counts" : [{
#各类标注物的个数统计
"label_meta_id" : 1848,
#标注物使用的标签ID
"label_num" : 1,
#标注物个数
"label_meta_name" : "V3D0504",
#标注物名称
"label_meta_desc" : "V3D0504",
#标注物描述
"label_meta_attr" : "{\"优先级\":\"0,1\"}",
#标注物额外属性
"label_meta_shape" : "multiBox",
#标注物形状，包含“bndbox、line、circle、polygon、points、dashed、cube_3d、multiBox、polygon_3d_v2、audio、text、line_3d、dash_3d、line_dash_3d、dash_line_3d、double_line_3d、double_dash_3d”
"label_meta_color" : "#7ed321",
#标注物颜色信息
"level" : 0
}, {
"label_meta_id" : 1849,
"label_num" : 1,
"label_meta_name" : "圆0504",
"label_meta_desc" : "圆0504",
"label_meta_attr" : "{\"优先级\":\"0,1\"}",
"label_meta_shape" : "circle",
"label_meta_color" : "#417505",
"level" : 0
}, {
"label_meta_id" : 1845,
"label_num" : 3,
"label_meta_name" : "线0504",
"label_meta_desc" : "线0504",
"label_meta_attr" : "{\"优先级\":\"0,1\"}",
"label_meta_shape" : "line",
"label_meta_color" : "#f5a623",
"level" : 0
}, {
"label_meta_id" : 1844,
"label_num" : 1,
"label_meta_name" : "点0504",
"label_meta_desc" : "点0504",
"label_meta_attr" : "{}",
"label_meta_shape" : "points",
"label_meta_color" : "#d0021b",
"level" : 0
}, {
"label_meta_id" : 1846,
"label_num" : 1,
"label_meta_name" : "框0504",
"label_meta_desc" : "框0504",
"label_meta_attr" : "{\"优先级\":\"0,1\"}",
"label_meta_shape" : "bndbox",
"label_meta_color" : "#f8e71c",
"level" : 0
}, {
"label_meta_id" : 1847,
"label_num" : 1,
"label_meta_name" : "多边形0504",
"label_meta_desc" : "多边形0504",
"label_meta_attr" : "{\"优先级\":\"0,1\"}",
"label_meta_shape" : "polygon",
"label_meta_color" : "#8b572a",
"level" : 0
}, {
"label_meta_id" : 1848,
"label_num" : 1,
"label_meta_name" : "obb0504",
"label_meta_desc" : "obb0504",
"label_meta_attr" : "{\"优先级\":\"0,1\"}",
"label_meta_shape" : "obb",
"label_meta_color" : "#8b572b",
"level" : 0
}
],
"image_meta_infos": [
#图片CAPTION、图片QA任务包含此字段,描述一帧数据（可多张图片）属性信息，包含标定项id、图片名称、传感器类型、图片大小、图片源的obs路径url、时间戳
{
"id": "3b...78",
"name": "camera03-268-19.jpg",
"source": "https://octopus-raw-da7.../label-data/task-2284/data/8/camera03-268-19.jpg",
"sensor": "camera03_0",
#传感器名称
"timestamp": 1669339994173,
"calibration_item_id": 268,
#标定项ID
"size": {
#图片尺寸
"width": 1920,
"depth": 3,
"height": 1020
}
}
],
"image_meta_info" : {
#2D非图片CAPTION、非图片QA任务包含此字段，描述图片信息
"id" : "c7...de",
"name" : "hash0-1590980980006.jpg",
#图片名称
"source" : "https://octopus-raw-ca.../label-data/task-922/data/hash0-1590980980006/hash0-1590980980006.jpg",
#图片源的obs路径url
"sensor" : "default_camera",
#传感器类型
"timestamp" : 1683185878405,
#时间戳
"calibration_item_id" : 0,
#标定项ID
"size" : {
#图片尺寸
"width" : 1920,
"depth" : 3,
"height" : 1080
}
},
"label_task_id" : 21376,
#批次子任务ID
"partitionId" : 20220826,
"label_update_time" : 1683187695480,
#标注最近更新时间
"prefix_folder" : "hash0-1590980980006",
"image_id" : "9f...46",
#图片id
"inspection" : 0,
"labels" : [
#标注物信息
{
"label_meta_id" : 1844,
#标注物对应的标签ID
"create_time" : 1683187362541,
"name" : "点0504",
#标注物名称
"shape_type" : "points",
#标注物形状：点
"serial_number" : 0,
#该帧中标注物唯一自增id
"label_object_id" : 0,
#标注物合成对象的唯一自增id，如果标注物之间没有合成则与 serial_number保持一致，追踪任务中同一物体在不同帧中此字段相同
"attribute" : "",
#标注物属性
"label_meta_name" : "点0504",
"points" : {
#点的坐标信息
"size" : 1,
"points" : [{
"xpoint" : 1233.4807,
"ypoint" : 689.4183
}
]
}
}, {
"label_meta_id" : 1845,
"create_time" : 1683187374024,
"line" : {
#线的坐标信息
"size" : 4,
"points" : [{
"xpoint" : 901.138,
"ypoint" : 553.583
}, {
"xpoint" : 731.36,
"ypoint" : 630.367
}, {
"xpoint" : 618.153,
"ypoint" : 681.566
}, {
"xpoint" : 360.516,
"ypoint" : 798.086
}
]
},
"name" : "线0504",
"shape_type" : "line",
#标注物形状:线
"serial_number" : 1,
"label_object_id" : 1,
"attribute" : "{\"优先级\":\"1\"}",
"label_meta_name" : "线0504"
}, {
"label_meta_id" : 1846,
"create_time" : 1683187387330,
"bndbox" : {
#矩形框坐标信息
"ymin" : 545.4334,
"xmin" : 1158.3188,
"ymax" : 705.71844,
"xmax" : 1436.3274
},
"name" : "框0504",
"shape_type" : "bndbox",
#标注物形状:矩形框
"serial_number" : 2,
"label_object_id" : 2,
"attribute" : "{\"优先级\":\"1\"}",
"label_meta_name" : "框0504"
}, {
"label_meta_id" : 1847,
"create_time" : 1683187417245,
"polygon" : {
#多边形的坐标信息
"size" : 3,
"points" : [{
"xpoint" : 135.03,
"ypoint" : 482.94937
}, {
"xpoint" : 84.318344,
"ypoint" : 554.4891
}, {
"xpoint" : 135.03,
"ypoint" : 482.94937
}
]
},
"name" : "多边形0504",
"shape_type" : "polygon",
#标注物形状：多边形
"serial_number" : 3,
"label_object_id" : 3,
"attribute" : "{\"优先级\":\"1\"}",
"label_meta_name" : "多边形0504"
}, {
"label_meta_id" : 1848,
"create_time" : 1683187426497,
"multiBox" : {
#2.5D框的坐标信息
"size" : 10,
"points" : [{
"xpoint" : 475.06976,
"ypoint" : 645.49835
}, {
"xpoint" : 602.3017,
"ypoint" : 645.49835
}, {
"xpoint" : 602.3017,
"ypoint" : 537.2833
}, {
"xpoint" : 475.06976,
"ypoint" : 537.2833
}, {
"xpoint" : 475.06976,
"ypoint" : 645.49835
}, {
"xpoint" : 664.7857,
"ypoint" : 632.3677
}, {
"xpoint" : 664.7857,
"ypoint" : 537.2833
}, {
"xpoint" : 602.3017,
"ypoint" : 537.2833
}, {
"xpoint" : 602.3017,
"ypoint" : 645.49835
}, {
"xpoint" : 664.7857,
"ypoint" : 632.3677
}
]
},
"name" : "V3D0504",
"shape_type" : "multiBox",
#标注物形状：2.5D
"serial_number" : 4,
"label_object_id" : 4,
"attribute" : "{\"优先级\":\"1\"}",
"label_meta_name" : "V3D0504"
}, {
"label_meta_id" : 1849,
"create_time" : 1683187565067,
"name" : "圆0504",
"shape_type" : "circle",
#标注物形状：圆
"serial_number" : 5,
"label_object_id" : 5,
"attribute" : "{\"优先级\":\"1\"}",
"label_meta_name" : "圆0504",
"circle" : {
#圆的坐标信息
"xcenter" : 795.6399,
"ycenter" : 554.03625,
"radius" : 31.255125
}
},{
"label_meta_id" : 1848,
"create_time" : 1683187387330,
"obb" : {
#obb框坐标信息
"center_x" : 545.4334,
"center_y" : 1158.3188,
"width" : 705.71844,
"height" : 1436.3274,
"angle" : 30.2, #顺时针方向，[0, 360)
},
"name" : "obb 0504",
"shape_type" : "obb",
#标注物形状:矩形框
"serial_number" : 2,
"label_object_id" : 2,
"attribute" : "{\"优先级\":\"1\"}",
"label_meta_name" : "obb 0504"
},{
"shape_type": "caption",
"caption": {"text":"this is a demo picture"}
},{
"shape_type": "qa",
"qa": {"question":"", "answer":""}
}
]
}
必须字段样例
数据集可视化
“.json”文件中必须包含label_counts和labels字段信息。
创建标注任务
“.json”文件中必须包含label_counts和labels字段信息。如果需要json文件中已有的标注信息在平台上直接展示，则label_counts里面的标注物名称、描述、形状、额外属性需要和创建任务使用的平台标签信息保持一致。示例如下：
{"label_counts" : [
#标注对象类型的个数统计
{
"label_meta_id" : 1846,
#标注物ID
"label_num" : 1,
#标注物个数
"label_meta_name" : "框0504",
#标注物名称
"label_meta_desc" : "框0504",
#标注物描述
"label_meta_attr" : "{\"优先级\":\"0,1\"}",
#标注物额外属性
"label_meta_shape" : "bndbox",
#标注物形状：矩形框
"label_meta_color" : "#f8e71c"
#标注物颜色信息
}
],
"labels" : [
{
"label_meta_id" : 1846,
"bndbox" : {
"ymin" : 545.4334,
"xmin" : 1158.3188,
"ymax" : 705.71844,
"xmax" : 1436.3274
},
"name" : "框0504",
"shape_type" : "bndbox",
"serial_number" : 2,
#该帧中标注物唯一自增id
"label_object_id" : 2,
#标注物合成对象的唯一自增id，如果标注物之间没有合成则与serial_number保持一致，追踪任务中同一物体在不同帧中此字段相同
"attribute" : "{\"优先级\":\"1\"}",
"label_meta_name" : "框0504"
}
]
}
父主题： OCTOPUS数据集格式说明
