文档中心

Viking AI 搜索

批量导入数据

BatchImport - 批量导入数据

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

在调用创建批式导入任务后（见：CreateBatchImport - 创建批量导入任务），使用返回的batch_id逐次导入批量数据。

说明

一个 batch_id 支持多次调用 BatchImport 接口。通过多次调用，可上传的所有数据将攒批进入同一个导入批次，上传完成后您可以调用完成上传接口完成该批次的导入操作，系统将自动开始后续的数据入库和处理流程。

当前批式导入数据仅支持物品数据集，支持以下数据操作：

批量导入新数据：适用于创建数据集后，批量导入全量候选数据。物品数据使用JSON Object列表形式上传。上传的数据 schema 必须遵循您在控制台创建数据集时定义的 schema。

批量更新数据：通过重复上传物品数据（传入的数据唯一标识已存在于数据集中）则触发数据更新，最新上传的数据将覆盖已有的数据。如果您只需要更新一批数据中的某几个字段，则每条数据仅需要上传物品数据的id和待更新字段。

注意

请勿创建多个批量任务来提高处理速度。由于任务调度花费的时间长，通过一个批量导入任务导入大量数据会比通过多个批量导入任务导入小量数据来的快

注意事项

任务有效期: 每个批量导入任务的有效生命周期为24小时，您需要在创建任务的24小时内完成数据导入并通过调用导入任务完成接口提交这批数据。过期后任务将自动失效。

接口请求体上限：您可以连续调用批量导入接口上传同一批内的数据，首接口的请求体大小限制，您每次接口调用的请求体不能超过10MB。

批量导入接口限流：批量导入接口限制请求频度 50QPS 。若您有更高的请求频率需求，请与我们取得联系。

请求说明

请求方式: POST

请求 URL:

服务	区域	URL
火山引擎	华北(北京)	https://aisearch.cn-beijing.volces.com/api/v1/dataset/{dataset_id}/batch_import
火山引擎	东南亚(柔佛)	https://aisearch.ap-southeast-1.volces.com/api/v1/dataset/{dataset_id}/batch_import
BytePlus	东南亚(柔佛)	https://aisearch.ap-southeast-1.bytepluses.com/api/v1/dataset/{dataset_id}/batch_import

请求参数

图文数据集请求体

参数	类型	是否必选	示例值	描述
batch_id	String	是	"a8fd2b826203421bb977"	创建批式导入任务时返回的batch_id
fields	Array of Object	是	[ { "item_id": "WSHOE001", "title": "舒适通勤尖头浅口高跟鞋 - 黑色", "category": "女士高跟鞋", "status": 1, "images": [ { "image_url": "https://example.com/images/womens_pump_black.jpg" } ] } ]	需要写入数据集的数据内容，输入 Array，Array 中每个元素为一条数据。

上传图片文件

上传数据时，请根据您已经在数据集中定义的字段类型来上传图片文件数据。您必须上传符合以下说明中格式和限制的图片文件，AI 搜索引擎才可以对图片进行处理并索引：

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

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

宽高比（宽/高）：在范围[1/100, 100] 。

边长： [10, 6000] px，即短边像素需大于 10 px，长边像素需小于6000 px。

您可以按照您在数据集配置中的属性定义，上传可公开访问的URL链接或使用Base64编码直接上传图片文件：

使用URL链接上传：请确保您的URL链接保持公开可访问，如果您的链接有访问限制，请对 aisearch.cn-beijing.volces.com 域名开放访问的白名单。

使用Base64编码的图片文件上传：请确保Base64编码符合标准格式，包含数据头（Data URI Scheme）与 Base64 编码正文两部分：

格式

JPEG 图片

PNG 图片

WebP 图片

视频数据集请求体

参数	类型	是否必选	示例值	描述
batch_id	String	是	"a8fd2b826203421bb977"	创建批式导入任务时返回的batch_id
fields	Array of Object	是	[ { "content_id": "video_900026", "content_type": "video", "parent_content_id": "collection_342534", "sequence_index": 26, "video_url": [ "http://xxxx.mp4" ], "my_title": "三体第二十六集" } ]	需要写入数据集的数据内容，输入 Array，Array 中每个元素为一条数据。

上传视频文件

上传数据时，请根据您已经在数据集中定义的字段类型来上传视频数据。在视频数据集中需要使用video_url（Array<String>）上传单个视频的url列表（支持多个视频片段拼接为1个视频）。视频的上传格式和要求如下：

视频格式和要求说明

在导入视频下载链接前，请确保这些视频的下载 URL 能够被火山引擎的官方接口域名访问。不支持通过上传任意网页链接来爬取网页上的视频。

在上传前，请确保列表内所有视频文件的总大小不超过 10GB，总时长不超过 3 小时。

支持上传以下格式的视频文件：

mp4、flv、asf、rm、rmvb、mpeg、mov、avi、mpegts、m4s、m3u8、matroska、wmv、3gp、ts、mpg、webm、mkv、wm、asx、ram、mpe、vob、dat、mp4v、m4v、f4v、mxf、qt

响应参数

请求响应

参数	类型	示例	描述
batch_id	String	6c0001b0-f696-4bfc-acda-a2ee05170485	批式导入任务的唯一标识符。
accepted_count	Integer	1000	本次请求成功接收的数据条数。
total_received	Integer	5000	任务累计已接收的数据总条数。
status	String	processing	任务的当前状态。 initialised：任务创建完成，尚未上传数据 processsing：已开始接收数据（首次 upload 后） completed：调用 Complete 接口结束导入 expired：任务过期，无法使用
expired_time	String	2025-11-19T14:23:45Z	任务的过期时间。

请求示例

图文数据集

视频数据集

图文数据集批量上传示例：

返回示例

错误码

请查看公共错误码

说明

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

最近更新时间：2026.08.09 01:06:40

这个页面对您有帮助吗？

有用

无用