上传数据
获取数据集信息
本接口用于获取数据集的基本信息
GET /v1/dataset/{{dataset_id}}
Request:
curl "https://domain.com/v1/dataset/{{dataset_id}}" \
-H "T-Key:{your_accesskey}" \
-H "Content-Type: application/json"
Response:
{
"code":"",
"msg":"",
"data":{
"hosting_method":1,
"endpoint":"xxx",
"bucket":"xxx",
"oss_type":1,
"dataset_type":1
"upload_token":"xxx"
}
}
返回字段说明
参数
类型
描述
hosting_method
int
该数据集使用的存储形式,0为系统自带的存储,1为自主授权的云存储,2为自有存储。使用自有存储时,无法使用SDK上传文件,仅支持添加文件URL。
endpoint
string
该数据集指定的OSS使用访问域名
bucket
string
该数据集指定的OSS存储捅
oss_type
int
当该数据集使用默认存储或者授权存储时,本字段表示OSS的类型,0表示默认存储,默认存储使用的是s3协议的存储,1表示阿里云存储,2表示亚马逊S3存储,3表示七牛云存储。
dataset_type
int
该数据集的数据类型,0表示图片类型,1表示视频类型,2表示音频类型,3表示普通点云类型,4表示点云融合数据,5表示点云语义分割类型,6表示文本类型。
upload_token
string
当oss_type为七牛云存储时,本字段会返回用于上传七牛的upload_token
获取临时上传OSS URL
本接口用于获取上传文件时的临时url,临时url用于保护您的OSS的AK SK不会泄露,除七牛外的已经支持的OSS存储类型均可调用本接口上传文件(七牛云支持upload_token的方式上传,upload_token已经在获取数据集信息的接口中返回)。
POST /v1/dataset/{{dataset_id}}/get-upload-url
Request:
POST "https://domain.com/v1/dataset/{{dataset_id}}/get-upload-url" \
-H "T-Key:{your_accesskey}" \
-H "Content-Type: application/json"
-d '{"object":"a/b/test.mp4"}'
请求数据说明
参数
类型
说明
object
string
存储至OSS的object名称,请传入您认为完整的路径。最终存放至OSS中,路径前缀将会是数据集ID。
Response:
{
"code": "",
"msg": "",
"data": {
"url": "xxxx"
}
}
返回字段说明
参数
类型
描述
url
string
用于上传文件至OSS的presigned URL
上传数据及标注结果
一份数据及对应的标注结果,支持多个文件数据一起提交(数组格式,如单个文件则支持单独object提交)upload到数据中心存储。
POST http://{{host}}/v1/dataset/{{dataset_id}}/upload
请求参数
参数
类型
是否必传
描述
ref_id
string
否
用于和业务系统中数据的对应检索的唯一ID,虽非必传,但强烈建议传入,否则后续将无法和业务系统关联。最大长度64
name
string
是
文件名称,最大长度256
path
string
是
资源文件的访问URL,最大长度4096
size
int
是
文件大小,单位KB
md5
string
是
文件摘要信息,长度32
frame_id
string
否
融合数据中必传,用于关联不同传感器数据用于可视化,最大长度64
sensor
string
否
融合数据中必传,用于融合数据关联显示和单独显示,为枚举值,pointcloud为点云,camera_0 至 camera_9为相机,23D融合中将按照序号显示
meta
object
否
用于检索的K/V信息,如{"weather":"sunny", "city":"beijing"}
请求样例
POST http://{{host}}/v1/dataset/{{dataset_id}}/upload
Content-Type: {{contentType}}
T-key: {{your_accesskey}}
[
{
"ref_id":"third_ref_id",
"name":"文件名称",
"path":"path/xxx/a.jpg",
"size":100,
"md5":"md5example-32length",
"frame_id":"frame_000001",
"sensor":"camera_0",
"meta":{"weather":"sunny","city":"beijing"},
"anotations":[
{
"label": "car",
"instance":"instance-id",
"type":"box2d",
"attrs":{"truncate":"yes"},
"data": {
"x":21.31,
"y":33.22,
"width":210,
"height":122
}
},
{
"label": "person",
"instance":"id",
"type":"polygon",
"attrs":"",
"data": [
{"x":22.22,"y":222.22},
{"x":22.22,"y":222.22},
{"x":22.22,"y":222.22}
]
}
]
}
]
Response:
{
"code": "",
"msg": "",
"data": {
"file_succ": 1,
"file_fail": 0,
"anotations_succ": 2,
"anotations_fail": 0
}
}
Last updated
Was this helpful?