:::tip \*说明 **Viking AI Search** is an enterprise\-grade AI search product based on generative AI. It uses the multimodal semantic representation and understanding capabilities of large language models, combined with years of best practices from ByteDance in information retrieval. Viking AI Search provides an out\-of\-the\-box AI search platform service that helps customers easily build and integrate end\-to\-end multimodal image and text search and recommendation capabilities. * To explore more Viking AI Search capabilities, visit: [Viking AI Search, an integrated intelligent engine for enterprise search, recommendation, and Q&A](https://www.volcengine.com/product/AI-Search-Rec) ::: --- After creating a batch import task (see: [CreateBatchImport - Create Batch Import Task](/docs/85296/2123233)), use the returned `batch_id` to import the batch data sequentially. When you invoke this API multiple times with the same `batch_id`, all uploaded data is collected into a single import batch. After the upload is complete, you can invoke the 'complete upload' API to finish the import operation for the batch. The system will then automatically start the subsequent data storage and processing workflow. Currently, batch data import only supports the item dataset and includes the following data actions: * **Batch import new data:** Use this when you need to batch import the full set of candidate data after creating a dataset. Upload item data as a list of JSON objects. The uploaded data schema must match the one you defined in the console when you created the dataset. * **Batch update data:** Uploading item data with a unique identifier that already exists in the dataset triggers an update. The newly uploaded data overwrites the existing data. If you only need to update certain fields in a batch of data, you only need to upload the item's ID and the fields to be updated for each record. ## Notes **Task validity period**: Each batch import task is valid for 24 hours. You need to complete the data import and submit this data batch by invoking the import task completion API within 24 hours of creating the task. The task automatically becomes invalid after expiration. **API request body limit:** You can successively invoke the batch import API to upload data within the same batch. The request body for each invocation cannot exceed 10MB. **Batch import API rate limit:** The batch import API is limited to a request frequency of **50 QPS**. If you require a higher request frequency, contact us. ## Request details * **Request method**: `POST` * **Request URL**: * North China: https://aisearch.cn\-beijing.volces.com/api/v1/dataset/`{dataset_id}`/batch_import * Johor: https://aisearch.ap\-southeast\-1.volces.com/api/v1/dataset/`{dataset_id}`/batch_import ## Request parameters ### Image and text dataset request body |**Parameter** |**Type** |**Required** |**Example value** |**Description** | |---|---|---|---|---| |batch_id |String |Yes |`"a8fd2b826203421bb977"` |The batch_id returned when a batch import task is created | |fields |Array of Object |Yes |Image and text data:|The data to write to the dataset. Input an array where each element is a single data entry. |\ | | | |```JSON| |\ | | | |［| |\ | | | | { | |\ | | | | "item_id": "WSHOE001", | |\ | | | | "title": "舒适通勤尖头浅口高跟鞋 - 黑色", | |\ | | | | "category": "女士高跟鞋", | |\ | | | | "status": 1,| |\ | | | | "images": [ | |\ | | | | { | |\ | | | | "image_url": "https://example.com/images/womens_pump_black.jpg" | |\ | | | | } | |\ | | | | ] | |\ | | | | }| |\ | | | |］| |\ | | | |```| |\ | | | | | | #### Upload image files When uploading data, upload image file data according to the data types defined in the dataset. You must upload image files that meet the format and restrictions described below for Viking AI Search to process and index them: :::tip \*Images must meet the following conditions: 1. **Supported formats:** jpeg, png, webp, bmp, tiff, ico, dib, icns, sgi, jpeg2000. For images in tiff, sgi, icns, and jpeg2000 formats, ensure alignment with metadata (e.g., setting the file metadata correctly in object storage), otherwise parsing will fail. 2. **Aspect ratio (width/height):** [1/100, 100]. 3. **Side length:** [10, 6000] px, i.e., the short side must be greater than 10 px and the long side must be less than 6000 px. ::: You can upload publicly accessible URL links or directly upload image files using Base64 encoding, according to the attributes defined in your dataset configuration: 1. **Upload using a URL link:** Ensure your URL link is publicly accessible. If your link has access restrictions, add the [aisearch.cn-beijing.volces.com](http://aisearch.cn-beijing.volces.com/) domain to the allowlist. 2. **Upload an image file using Base64 encoding:** Ensure the Base64 encoding follows the standard format, which includes a **data header (Data URI scheme)** and a **Base64\-encoded body**: ```mixin-react return ( ;base64, \`\`\` `}> \`\`\` `}> \`\`\` `}> \`\`\` `}>); ``` ### Video dataset request body |**Parameter** |**Type** |**Required** |**Example value** |**Description** | |---|---|---|---|---| |batch_id |String |Yes |`"a8fd2b826203421bb977"` |The `batch_id` returned when a batch import task is created. | |fields |Array of Object |Yes |```JSON|The data to write to the dataset. Enter an array where each element is a single data record. |\ | | | |[| |\ | | | | {| |\ | | | | "content_id": "video_900026",| |\ | | | | "content_type": "video",| |\ | | | | "parent_content_id": "collection_342534",| |\ | | | | "sequence_index": 26,| |\ | | | | "video_url": [| |\ | | | | "http://xxxx.mp4"| |\ | | | | ],| |\ | | | | "my_title": "三体第二十六集"| |\ | | | | }| |\ | | | |]| |\ | | | |```| |\ | | | | | | #### Upload video files When you upload data, upload the video data according to the data type you have defined in the dataset. In a video dataset, use video_url (Array) to upload a list of URLs for a single video (supports splicing multiple video clips into 1 video). The upload format and requirements for videos are as follows: :::tip \*Video formats and requirements 1. Before you import video download URLs, ensure that they can be accessed by the official Volcano Engine API domain. Uploading webpage links to crawl videos is not supported. 2. Before uploading, ensure that for all video files in the list, **the total size is no more than 10 GB and the total duration is no more than 3 hours**. 3. You can upload video files in the following formats: 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 ::: ## Response parameters ### Request response |**Parameter** |**Type** |**Example** |**Description** | |---|---|---|---| |`batch_id` |String |`6c0001b0-f696-4bfc-acda-a2ee05170485` |The unique identifier for the batch import task. | |`accepted_count` |Integer |`1000` |The number of data entries successfully received for this request. | |`total_received` |Integer |`5000` |The total number of data entries received for the task. | |`status` |String |`processing` |The current Status of the task. | |`expired_time` |String |`2025-11-19T14:23:45Z` |The expiration time of the task. | ## Request example ```mixin-react return ( ' \\ -d '{ "batch_id":"a8fd2b826203421bb977", "fields": [ { "item_id": "WSHOE001", "title": "舒适通勤尖头浅口高跟鞋 - 黑色", "category": "女士高跟鞋", "status": 1, "images": [ { "image_url": "https://example.com/images/womens_pump_black.jpg" } ] }, { "item_id": "WSHOE002", "title": "轻便网面跑步运动鞋 - 粉色拼灰色", "category": "女士运动鞋", "status": 1, "images": [ { "image_url": "https://example.com/images/womens_sneaker_pink.jpg" } ] } ] }' \`\`\` `}> ' \\ -d '{ "fields": [ { "content_id": "video_900026", "content_type": "video", "parent_content_id": "collection_342534", "sequence_index": 26, "video_url": [ "http://xxxx.mp4" ], "my_title": "三体第二十六集" }, { "content_id": "video_900027", "content_type": "video", "parent_content_id": "collection_342534", "sequence_index": 27, "video_url": [ "http://xxxx.mp4" ], "my_title": "三体第二十七集" } ] }' \`\`\` `}>); ``` ## Response example ```Plain Text { "request_id": "41feb961-6b21-94e0-ba4e-c063aaff0784", "result": { "batch_id": "a8fd2b826203421bb977", "accepted_count": 2, "total_received": 2, "status": "processing", "expired_time": "2025-12-17T21:15:59+08:00" } } ``` ## Error codes View [Common Error Codes](/docs/85296/1544941) :::tip \*说明 To experience more Viking AI Search capabilities, go to: [Viking AI Search, the all-in-one intelligent engine for enterprise search, recommendations, and Q&A](https://www.volcengine.com/product/AI-Search-Rec) :::