文档中心

Viking AI 搜索

推荐接口

Deduplicate - 去重物品接口

写入去重物品列表

去重接口支持客户端主动上报物品 ID，实现实时屏蔽。该接口解决了以下问题：服务端去重因客户端缓存导致物品未实际曝光，以及跨渠道行为无法感知所引发的误过滤问题。

说明

26 年 1 月 6 日后创建的推荐场景将自动启用曝光去重能力；此前创建的历史场景将保留原有的下发去重能力。

核心能力

通过此接口上报的数据将用于推荐系统的曝光去重能力。曝光去重仅对用户实际看到的物品进行去重，从而避免高质量内容因未曝光而被长期过滤，防止内容缺失。

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

*前置操作

调用接口前，必须在对应推荐策略中配置「关联的页面 / 模块」

配置详情请参考去除已曝光的物品。若未完成配置，接口将返回错误。

请求说明

服务	区域	URL
火山引擎	华北(北京)	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
BytePlus	东南亚(柔佛)	https://aisearch.ap-southeast-1.bytepluses.com/api/v1/application/{application_id}/deduplicate

请求参数

请求体

参数	类型	是否必传	示例值	描述
event_scene	String	必选	"homepage"	行为发生场景用户行为发生的位置或功能场景描述，必须与行为数据集「行为发生场景」中的值对应。 *注意需在「推荐体验」界面完成「关联界面」配置，否则接口将返回错误。
user	User	必选	见： User	用户信息用于关联去重物品与具体用户，支持登录用户 ID。用户 ID 获取逻辑必须和行为数据内的用户 ID 一致。
items	Array<Item>	必选	见：Item	曝光物品需要去重的曝光物品列表，每个物品对象结构见下文 Item 定义。

数据结构

User

参数	类型	是否必传	示例值	描述
_user_id	String	必选	"user_id_123"	用户的唯一标识未登录用户可在确保全局唯一的前提下使用设备 ID 等作为虚拟用户 ID。用户 ID 获取逻辑必须和行为数据内的用户 ID 一致。

Item

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

响应参数

请求响应

参数	类型	示例值	描述
request_id	String	"25ee998a-5462-9385-9f18-035f1da7a6e5"	请求 ID 请求唯一标识，用于快速定位单次请求记录。

接口示例

错误处理

常见报错

若返回 InternalServiceError 错误，请检查以下两点：

错误响应示例：

错误码

其他错误码请参见：公共错误码。

最近更新时间：2026.08.09 01:08:54

这个页面对您有帮助吗？

有用

无用