文档中心

Viking AI 搜索

准备数据集

图文物品数据集介绍

Viking AI 搜索是一款基于生成式 AI 的企业级 AI 搜索产品，基于大模型的多模态语义表征和理解能力，结合字节跳动信息检索领域多年最佳实践，为客户提供开箱即用的 AI 搜索搭建平台服务，帮助客户轻松搭建和集成端到端的多模态图文搜索和推荐能力。想要体验更多 Viking AI 搜索能力，点击前往：Viking AI 搜索引擎，企业搜推问一体化智能引擎

若您希望将平台上的图文内容（如商品信息、新闻资讯、设计素材等）整合进搜索与推荐系统，并实现基于内容的问答与信息提取，图文数据集是理想的解决方案。图文数据集支持您上传包含图片和相关文本描述的数据。系统将自动调用多模态预处理和理解能力，深度解析图像视觉信息与文本语义内容，并将这些图文内容索引。

图文搜索适用于以下数据内容：

商品数据：每条数据为一个商品（SKU或SPU，取决于您希望在搜索和推荐时对用户展示的商品卡片对应的商品层级），可包含商品ID、名称、描述信息、参数信息、价格以及商品详情图片、商品头图等图片信息

设计图文素材：每条数据为一个商用素材，可包含素材的商品ID、名称、大缩略图（以url导入）、描述信息、关键词等信息

图文新闻文章：每条数据为一个新闻文章，可包含新闻内容的ID、标题、文本正文和附带图片

以及其他包含图片和文本信息的结构化数据。

图文数据格式

图文数据集支持自由的schema定义，即我们不限制数据字段名称，您可以自定义JSON结构（字段名、字段类型）来上传任意的图文信息来描述被搜索的数据内容。您可以使用控制台创建AI搜索应用时创建数据集，上传一条或多条JSON数据来进行schema解析，控制台的大模型数据解析功能可为您解析字段结构和字段名称、特殊属性和数据集内容摘要。

字段名称：必须以字母开头，且只能包含字母、数字和下划线，字段名不超过32个字符。

字段类型：支持JSON schema的以下核心数据类型

String (Array<String>)

Integer (Array<Integer>) ：支持定义Int64和Int32

Float (Array<Float>)

Boolean

Object (Array<Object>)：支持字段中包含Object嵌套对象，最多支持三层嵌套关系

以下是一条图文数据示例：

传输图片数据

支持在图文数据集中使用String或Array<String>类型的属性字段来传入图片数据。每条数据支持使用多个字段来区分不同的图片类型，用来区分图片字段的用途。

例子：在电商平台场景下，一条商品数据可能包含多类图片，如商品列表页面的展示头图、商品顶部轮播图和商品详情页图。其中商品列表页面的展示头图通常用于搜索结果和分类页展示，可能包含商品的完整外观，商品顶部轮播图用于商品详情页顶部展示多角度商品图，而商品详情页图则包含商品细节、尺寸说明的文字长图信息。前两者更适合用于商品图搜的特征，而详情页图片更适合使用大模型解读后参与导购问答。

传入包含一张图片的字段：

使用String类型的字段传入包含一张图片的字段，适用于商用图片素材搜索场景传入素材缩略图，或在商品数据中传入商品列表页展示头图。

传入包含多张图片的字段：

使用Array<String>类型的字段传入可包含多张图片的字段，适用于商品数据中传入商品详情图（包含商品图文描述信息）和商品顶部轮播图（包含商品的完整外观展示）。

图片导入方式

使用URL下载链接导入图片

您可以在字段中传入图片分发下载链接（String）来导入图片，您需要保障图片的下载链接是公开可访问的。导入数据后AI 搜索引擎会将图片进行下载拉取，并用于后续的图片理解和多模态数据索引。

使用Base64导入图片（不推荐）

如果您的数据库中存储了图片原始文件但没有设置图片分发服务，则可以在字段中直接传入Base64编码的图片文件。

请确保您的图片Base64编码符合标准格式，包含数据头（Data URI Scheme）与 Base64 编码正文两部分，以保障base64编码可被正确解析：

组成部分	格式要求	说明
数据头前缀	固定为 data:	标识该字符串为 Data URI 格式，不可省略或修改
MIME 类型	需与图片实际格式严格匹配	用于服务端识别图片类型，禁止随意填写（如 JPG 图填 PNG 的 MIME）
分隔符	固定为 ;base64,	连接 MIME 类型与 Base64 编码正文，分号、“base64”、逗号均不可省略或替换
Base64 编码正文	符合 RFC 4648 标准的 Base64 编码字符串	由图片文件二进制数据直接编码生成，禁止包含空格、换行符、特殊字符，需为连续的 ASCII 字符串

格式

JPEG 图片

PNG 图片

WebP 图片

注意

使用Base64上传图片会使数据导入接口的请求和返回体较大，影响数据上传和查询的时效性。建议使用图片URL来上传图片数据。

图片格式说明

在导入数据前请确保图片的格式满足要求：

传入图片需要满足以下条件：

支持格式：jpeg、png、 webp、bmp、tiff、ico、dib、icns、sgi、jpeg2000。其中，tiff、sgi、icns、jpeg2000 格式图片，需要保证和元数据对齐，如在对象存储中正确设置文件元数据，否则会解析失败。

不能支持动图(.gif)或任何矢量图文件（如.svg、.eps、.ai等格式），如果您的素材图片中包含矢量图，请转为位图缩略图再进行传入。

宽高比（宽/高）：在范围[1/100, 100] 。最佳不超过[1/10, 10]之间，极端的图片比例可能影响大模型图片理解和图片特征搜索匹配的效果。

边长：必须在[10, 6000] px范围内，即短边像素需大于 10 px，长边像素需小于6000 px，否则将无法进行图片处理。为了获得最佳的模型处理效果，建议将图片边长控制在[300, 3600] px范围内，过小的分辨率可能导致细节丢失，而过大的分辨率会增加处理时间且不会显著提升识别精度。

检查预留字段属性

字段的“属性”为一系列预留的字段配置，在创建数据集时会引导您进行配置，配置为特定属性的字段将会进行特殊的处理并在搜索、推荐、对话时应用于内容理解和排序策略。在准备数据时，您可以预先判断您的数据库中是否包含以下信息，我们建议您将这些属性以既定格式传入，来最大化地利用AI 搜索引擎的智能数据处理和在线策略。

属性	是否为必需属性	支持的字段类型	属性介绍
物品ID（唯一标识）	必需	String	一条数据的唯一标识，即数据的主键，在搜索和推荐场景下换一个ID代表一个“候选”，数据schema中必须包含且仅包含一个唯一标识。支持以String类型上传只支持最外层非嵌套字段作为唯一标识
标题	非必需	String	存储了物品标题或名称的字段。适用于：商品名称、内容或文章标题等信息。建议上传标题数据，标题数据会作为一条数据的核心语义信息参与搜索和个性化推荐
图片链接	非必需	String, Array<String>	存储了图片URL的字段，上传数据后系统将自动拉取图片并提取视觉特征进行多模态理解，如果您希望使用URL上传图片进行多模态搜索，则需要将存储了图片URL的字段标注为图片URL属性。支持字符串或字符串列表字段。
图片Base64	非必需	String, Array<String>	存储了图片base64字符串（列表）的字段。
分类/类目	非必需	String	存储了物品所属的类别、类目、品类的字段。商品数据中建议上传这类属性，类目信息会作为核心的数据特征参与搜索和推荐，并在对话助手的决策流程中基于用户的问题对品类进行智能的过滤。支持上传多个分类属性，如果您的商品有多重类目（一级、二级类目），可以使用不同的字段来上传。
上新时间（时间日期格式）	非必需	String	使用日期和时间格式的字符串存储的物品上新/上架时间，可用于搜索和推荐的新度排序。支持上传的格式包含：标准的ISO时间日期字符串（YYYY-MM-DDThh:mm:ss+08:00）非标准的时间日期字符串（YYYY-MM-DD hh:mm:ss或精确到日期的字符串）也支持解析，系统会自动转换为标准格式存储。
上新时间（UNIX时间戳，精确到秒）	非必需	Int64	使用标准10位UNIX时间戳表示的物品上新/上架时间，可用于搜索和推荐的新度排序策略。
上新时间（UNIX时间戳，精确到毫秒）	非必需	Int64	使用标准13位UNIX时间戳表示的物品上新/上架时间，可用于搜索和推荐的新度排序策略。
地理位置-经度	非必需	Float 或 String	使用字符串或浮点数表示的经度纬度信息，用来标识物品的所处位置，支持对以下类型的字段进行配置：使用一个JSON对象标识经度和纬度，如："location":{"lat":"12.709","long":"30.281"} 使用JSON对象列表来标识物品可能关联的多个地理位置，如:"location":[{"lat":"12.709","long":"30.281"},{...},...]，在对地理位置进行操作时会按策略选择最大、最小距离进行计算可支持传入浮点数，或使用字符串表示经度或纬度的数值，例如"30.281"或30.281。
地理位置-纬度	非必需	Float 或 String

数据示例

以下是一条图文数据示例：

示例字段	字段类型	字段属性	字段含义
product_id	String	唯一标识	商品的唯一ID
title	String		商品标题
images	Object		商品包含的图片信息
images.primary	String	图片URL	商品主形象图
images.gallery	Array<String>	图片URL	商品详情轮播图，包含商品的主要信息图片
price	Object		商品的价格信息
price.current	Float		商品当前展示价格
price.original	Float		商品历史价格
price.discount_percentage	Float		商品折扣（百分比）
specs	Object		商品参数
processor	String		处理器
memory	String		内存
storage	String		电脑存储空间和介质

说明

想要体验更多 Viking AI 搜索能力，点击前往：Viking AI 搜索引擎，企业搜推问一体化智能引擎

最近更新时间：2026.08.09 01:05:51

这个页面对您有帮助吗？

有用

无用