Deduplicate - 去重接口--全域AI搜索-火山引擎

文档中心

立即注册

全域AI搜索

OpenAPI

Deduplicate - 去重接口

接口概述

去重接口用于支持客户端主动上报物品 ID 进行实时屏蔽，解决服务端去重因客户端缓存未曝光、跨渠道行为无法感知导致的误过滤问题。

核心能力

这个接口传入的数据会被用于推荐「曝光去重」的能力。曝光去重会避免高质量物品流失，场景只会去重用户实际看到物品，避免未曝光物品长期被过滤所导致的内容缺失问题。

说明

26 年 1 月 6 日后创建的推荐场景，自动使用曝光去重能力。历史创建的场景都会保留现有的下发去重能力。

新场景可以照常使用去重接口
历史场景如果想使用去重接口，需要先升级至「曝光去重」能力，更多详情请参考升级历史场景。

利用去重接口，您可以手动更新每个「推荐发生界面」的去重物品，支持：

跨渠道曝光感知：解决跨渠道曝光无法感知造成的重复推荐问题
客户端主动权：将去重的主动权交给客户管理，支持全场景覆盖

注意

通过接口接收的物品 ID，行为发生时间会自动更新为数据接收时间。

请求说明

请求方式：POST
请求地址：
- 华北：https://aisearch.cn-beijing.volces.com/api/v1/application/{application_id}/deduplicate
- 柔佛：https://aisearch.ap-southeast-1.volces.com/api/v1/application/{application_id}/deduplicate

{application_id}：在控制台创建应用后系统指定的应用唯一标识，可在控制台查看

鉴权方式

可使用 API Key 或 Access Key 鉴权，详情参考 API 鉴权机制说明。

请求参数

请求体

参数	类型	是否必传	示例值	描述
event_scene	String	`必传`	`"homepage"`	行为发生场景用户行为发生的位置或功能场景描述
user	User	`必传`	见： User	用户信息用于明确去重物品关联的用户。
items	Array<Items>	`必传`	见：Items	曝光物品用于明确哪些物品被去重。

数据结构

User

参数	类型	是否必传	示例值	描述
_user_id	String	`必传`	`"user_id_123"`	用户的唯一标识用于明确去重物品关联的用户。未登入用户，在确保全局唯一前提下，可以利用类似器材ID的当做虚拟用户 ID。

Items

参数	类型	是否必传	示例值	描述
_id	String	`必传`	`"item_id_123"`	物品的唯一标识必须传入需要去重的物品唯一标识，物品 ID 必须在物品数据集内存在。

响应参数

请求响应

参数	类型	示例值	描述
request_id	String	`"25ee998a-5462-9385-9f18-035f1da7a6e5"`	请求 ID 一次请求的唯一标识，支持快速定位到一次请求。

接口示例

curl -X POST 'https://aisearch.cn-beijing.volces.com/api/v1/application/\${application_id}/deduplicate' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <API Key>' \
  -d '{
      "event_scene": "hompage",
        "user": {
            "_user_id": "user_id_12"
        },
        "items": [
            {"_id": "item_id_1"},
            {"_id": "item_id_2"}
        ]
}'

最近更新时间：2026.01.23 18:01:38

这个页面对您有帮助吗？

有用

无用

全域AI搜索

核心能力 #

鉴权方式 #

请求体 #

数据结构 #

User #

Items #