智能搜索API

功能概述

CleverSee AI搜问平台提供的搜索API接口，支持通过平台搭建搜索应用后，通过应用对应的API调用搜索接口，实现对数据集中图片、文档及音视频内容的精准检索。平台支持文本（自然语言）、图片或图文结合的输入，可快速适配多模态的大规模数据搜索场景，帮助用户高效定位目标内容。

接口说明

当前接口支持CleverSee AI 搜问平台上两类搜索应用的调用，包括图片搜索应用内的文（自然语言）搜图、图搜图、图文混合搜图，以及音视频搜索应用内的文搜音视频、图搜视频、图文混合搜视频。

数据源：

支持音频、视频数据，可通过CleverSee AI 搜问平台的产品界面内或通过数据集数据新增/更新 API完成数据上传及更新。

认证方式

通过 阿里云 SDK 调用 CleverSee - 智能搜索 服务，具体调用指南请参考：AI搜索引擎接口

请求参数

请求参数表

请求示例

正常请求示例

JSON格式

curl -X POST 'https://pre-ai-search-engine.aliyun-inc.com/api/v1/engine/search' \
    -H 'Content-Type: application/json' \
    -H 'X-Acs-Account-Id: 1754376654452940' \
    -d '{
      "appId": "2048962366415007746",
      "query": {
        "texts": ["小女孩"],
        "imageUrls": ["https://你的图片url"],
        "pageSize": 10,
        "pageNo": 1,
        "excludeIds": []
      },
      "user": {
        "userId": "asdfgnoevnor"
      }
    }'

返回参数

3.1 顶层结构表

3.2 items 元素结构详解

items 数组中的每个对象代表一条搜索结果。根据媒体类型（图片、视频、音频），content 字段内的具体属性会有所不同。以下为通用结构及视频/音频特有字段：

图片搜索items 

音视频搜索items 

返回示例

正常图片搜索返回示例

JSON格式

  {
    "code": 200,
    "message": "success",
    "data": {
      "size": 1,
      "page": 1,
      "total": 1,
      "traceInfo": null,
      "extra": {
        "exclude_ids": ["3f95b343xxxxxxxxxxxx"]
      },
      "items": [
        {
          "id": "3f95b343xxxxxxxxxxxx",
          "score": 0.8029279573006508,
          "content": {
            "s_name": "sample_image.png",
            "image_url": "https://.../image.png?Expires=...",
            "pk_id": "3f95b343xxxxxxxxxxxx",
            "s_dataset_id": "594"
          },
          "algorithm": {},
          "traceInfo": null
        }
      ],
      "status": "200",
      "errorMessage": null
    },
    "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }

正常视频搜索返回示例

JSON格式

{
  "code": 200,
  "data": {
    "total": 1,
    "size": 1,
    "traceInfo": null,
    "extra": {
      "exclude_ids": ["01XXXXXXXXXXXXXXX"]
    },
    "errorMessage": null,
    "page": 1,
    "items": [{
      "score": 0.577594,
      "traceInfo": null,
      "id": "01XXXXXXXXXXXXXXX",
      "content": {
        "s_raw_file_path": "https://.../video.mp4?Expires=...",
        "s_raw_length": 1036122,
        "pk_id": "01XXXXXXXXXXXXXXX",
        "s_global_summary": "视频前半段围绕人物之间的冲突与协作展开，通过多段剧情推进呈现复杂关系与情绪变化，包含追逐、对话、调查等情节；后半段切换为舞台表演内容，展示歌手在大型活动中的现场演唱与观众互动，整体内容兼具剧情叙事与音乐演出元素。",
        "s_raw_cover_pic": "https://.../frame_1.jpg?Expires=...",
        "s_name": "demo_video.mp4",
        "s_dataset_id": "833",
        "s_global_keywords": "剧情互动,人物关系,调查追逐,音乐表演,舞台演唱",
        "s_video_topic": "剧情内容与音乐演出",
        "s_video_type": "影视综艺"
      },
      "algorithm": {}
    }],
    "status": "200"
  },
  "requestId": "xxxxxxxxxxxxxxxxxxxxxxxx",
  "message": "success"
}

错误码

搜索结果中多媒体资源（图片）

如需获取数据集内数据url链接并进行下载，请参考搜索结果中多媒体资源（图片、视频）URL获取预签名 API