自然语言检索图片

POST /v2/dataSpaces/{data_space_id}/repos/{repo_id}/files:clipSearch

请求头（Request Header）

请求参数（Request Parameters）

名称	类型	必须	位置	默认值	取值范围	描述
data_space_id	string	是	path	-	-	数据空间ID.
repo_id	string	是	path	-	-	数据集ID.

请求体（Request Body）

名称	类型	必须	位置	默认值	取值范围	描述
repo_id	string	是	path	-	-	数据集ID.
commit_id	string	否	-	-	版本ID.
text	string	否	-	-	检索文本, 为空的时候不过滤.
min_similarity	double	否	-	-	最小相似度.
page_size	integer	否	10	0-1000	本次请求的分页大小.
page_token	string	否	-	-	上次请求返回的next_page_token.

请求示例（Request Example）

curl --location 'https://aidmp.cn-sh-01.sensecoreapi.dev/aids/aidmp/data/v2/dataSpaces/ecfcd941-575c-11ee-9d6f-46f164dda338/repos/ec21087e-1c68-4a86-9199-8130e346d183/files:clipSearch' \
--header 'Content-Type: application/json' \
--data 'repo_id":"ec21087e-1c68-4a86-9199-8130e346d183",
"page_size":2,
"page_token":"",
"commit_id":"5a4f997667b1440493e3ec472bb61a05",
"text":"骑自行车的小孩"}'

响应（Response）

名称	类型	描述
repo_annotation_files	array[object]	文件列表.
next_page_token	string	请求返回的 next_page_token.

其中，repo_annotation_files的参数如下

名称	类型	描述
file	object	文件信息.
preview_uri	string	预览的url.
similarity	double	相似度.
annotations	object	标注数据.

其中，file的参数如下

名称	类型	描述
file_name	string	文件名.
path	string	路径.
hash	string	哈希值，目前为 SHA256.
size	integer	文件大小，以 Byte 为单位.
type	integer($enum)	同 HashNode.type，用于区分大小文件、文件夹.
file_type	integer($enum)	根据后缀判断的文件类型，文件夹没有该字段.
commit	object	所属 commit 信息.
presign_uri	string	文件链接.

其中，type有如下情况

状态	数值	含义
DIR	0	文件夹
FILE	1	文件
TINY_FILE	2	小文件
LARGE_FILE	3	大文件

其中，file_type有如下情况

状态	数值	含义
OTHER	0	其他
AUDIO	1	音频
TEXT	2	文本
IMAGE	3	图片
VIDEO	4	视频
PCD	5	点云

其中，commit的参数如下

名称	类型	描述
id	string	版本ID.
repo_id	string	数据集ID.
depth	integer	版本深度，第4个提交的深度是4.
branch_id	string	分支ID.
pid	string	上一个版本节点ID.
merge_from	string	从版本节点合并的版本节点信息.
create_user_id	string	创建者ID.
create_user_name	string	创建者用户名.
commit_message	string	版本提交信息.
create_time	string($date-time)	创建时间.
update_time	string($date-time)	最后更新时间.

其中，annotations的参数如下

名称	类型	描述
task_name	string	任务名称.
annotation_path	string	标注路径.
type	integer($enum)	标注任务类型.
is_prediction	boolean	是否是算法预测的.
confidence	string	置信度.
category	string	物品类型 type=0｜1｜2的时候有值.
segmentation	string	标注数据array[float] type=0｜1｜2的时候有值。
area	string	标注面积,多少个像素点;type=0｜1｜2的时候有值。
annotation_file_uri	string	标注图片url;type=3
key_points	array[float]	关键点的位置，每个关键点由三个数字组成：x, y, 标注状态（0 = 未标注，1 = 标注了但被遮挡，2 = 标注了也未被遮挡, 所以数组长度=len(categories)*3
category_info	array[object]	图片中物品类型信息，和annotation_file_url一起使用.
labels	string	标签信息,json格式,例如{"a":"b","aa":"bb"}.
annotation_info	string	标注文件内容，senseBee标注类型的时候有值.

其中，type有如下情况

状态	数值	含义
CV_RLE_OBJECT_DETECTION	0	cv物品标注RLE模式
CV_POLYGON_OBJECT_DETECTION	1	cv物品多边形标注
CV_KEYPOINT_DETECTION	2	cv关键点标注
CV_SEMANTIC_SEGMENTATION	3	cv语义分割
CV_INSTANCE_SEGMENTATION	4	cv实例分割
CV_PANOPTIC_SEGMENTATION	5	cv全景分割

其中，category_info的参数如下

名称	类型	描述
name	string	类别名称
super_category	string	超类名称
is_thing	integer($int32)	全景分割/语义分割/实例分割的名词，false代表这个东西是有复数形式的人、车等物体，true是无复数形式的草地、天空
color	array[integer($int32)]	颜色[R,G,B]
key_point	array[string]	关键点
skeleton	array[object]	骨骼数据

其中，skeleton的参数如下

名称	类型	描述
single_skeleton	array[integer($int32)]	一个骨骼数据是一个数组

响应示例（Response Example）

{
  "repo_annotation_files": [
    {
      "file": {
        "file_name": "000000210299.jpg",
        "path": "val2017",
        "hash": "dbdcbb432c918d11747928a3eb0d80498b9cc52087b5fe515e17b3cffb7e8240",
        "size": "236945",
        "type": 2,
        "file_type": 3,
        "commit": {
          "id": "2f2f468c1f794adc902dd33914529a3c",
          "repo_id": "d4bada70-469c-4066-b0a2-9451a5215fd8",
          "depth": 2,
          "branch_id": "da6eeefa-8201-4a07-99bf-9a9a0f210d77",
          "pid": "539d203631e1404c85720155a97d5c9b",
          "merge_from": "",
          "create_user_id": "",
          "create_user_name": "adimpklz1202",
          "commit_message": "add files",
          "create_time": "2023-01-03T10:37:52.676Z",
          "update_time": "2023-01-03T10:48:15.644Z"
        }
      },
      "preview_uri": "https://aoss.cn-sh-01.sensecoreapi-oss.cn/aidmpsys2/graviton/repo/d4bada70-469c-4066-b0a2-9451a5215fd8/cache/db/dcbb432c918d11747928a3eb0d80498b9cc52087b5fe515e17b3cffb7e8240?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=4A645E96D7694929AFB41472D565A5E7%2F20231007%2Fdefault%2Fs3%2Faws4_request&X-Amz-Date=20231007T094435Z&X-Amz-Expires=7200&X-Amz-SignedHeaders=host&X-Amz-Signature=2dfe52a644122437260670a1059a1673107129eb75e36b3057d55f2a36d86127",
      "similarity": 0.28564101457595825,
      "annotations": []
    },
    {
      "file": {
        "file_name": "COCO_val2014_000000210299.jpg",
        "path": "val2014",
        "hash": "dbdcbb432c918d11747928a3eb0d80498b9cc52087b5fe515e17b3cffb7e8240",
        "size": "236945",
        "type": 2,
        "file_type": 3,
        "commit": {
          "id": "2f2f468c1f794adc902dd33914529a3c",
          "repo_id": "d4bada70-469c-4066-b0a2-9451a5215fd8",
          "depth": 2,
          "branch_id": "da6eeefa-8201-4a07-99bf-9a9a0f210d77",
          "pid": "539d203631e1404c85720155a97d5c9b",
          "merge_from": "",
          "create_user_id": "",
          "create_user_name": "adimpklz1202",
          "commit_message": "add files",
          "create_time": "2023-01-03T10:37:52.676Z",
          "update_time": "2023-01-03T10:48:15.644Z"
        }
      },
      "preview_uri": "https://aoss.cn-sh-01.sensecoreapi-oss.cn/aidmpsys2/graviton/repo/d4bada70-469c-4066-b0a2-9451a5215fd8/cache/db/dcbb432c918d11747928a3eb0d80498b9cc52087b5fe515e17b3cffb7e8240?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=4A645E96D7694929AFB41472D565A5E7%2F20231007%2Fdefault%2Fs3%2Faws4_request&X-Amz-Date=20231007T094435Z&X-Amz-Expires=7200&X-Amz-SignedHeaders=host&X-Amz-Signature=2dfe52a644122437260670a1059a1673107129eb75e36b3057d55f2a36d86127",
      "similarity": 0.28564101457595825,
      "annotations": []
    }
  ],
  "next_page_token": "eyI2MzAwMjciOjIwfQ=="
}

自然语言检索图片

请求头（Request Header）​

请求参数（Request Parameters）​

请求体（Request Body）​

请求示例（Request Example）​

响应（Response）​

响应示例（Response Example）​