:::tip \*说明 **Viking AI Search** is an enterprise\-grade AI search product based on generative AI. It combines the multimodal semantic representation and understanding capabilities of large models with ByteDance's years of best practices in information retrieval. The platform offers an out\-of\-the\-box service for customers to easily build and integrate end\-to\-end multimodal search and recommendation capabilities for images and text. * To experience more Viking AI Search capabilities, click to visit: [Viking AI Search Engine, an integrated intelligent engine for enterprise search, recommendation, and Q&A](https://www.volcengine.com/product/AI-Search-Rec) ::: Call this API to create a batch data import task and get a unique task ID. You can then use this ID to batch import item data or check the task status. We currently support batch import tasks for item data. ## Notes **Task Validity Period**: Each batch import task is valid for 24 hours. You must complete the data import and submit the data by calling the complete import task API within 24 hours of creating the task. The task automatically becomes invalid upon expiration. **Task Creation Request Frequency**: You can create up to one batch import task per minute. Avoid frequently creating multiple batch import tasks. ## Request Description * **Request Method**: `POST` * **Request URL**: * North China: https://aisearch.cn\-beijing.volces.com/api/v1/dataset/`{dataset_id}`/create_batch_import * Johor: https://aisearch.ap\-southeast\-1.volces.com/api/v1/dataset/`{dataset_id}`/create_batch_import ## Request parameters |**Parameter** |**Type** |**Required** |**Example** |**Description** | |---|---|---|---|---| |`estimated_count`|Integer|Optional |`1000000` |Estimated total number of data entries for this bulk import. |\ | | | | | | ## Response parameters ### Request response |Parameter |Type |Example |Description | |---|---|---|---| |`batch_id` |String |`6c0001b0-f696-4bfc-acda-a2ee05170485` |The unique identifier for the batch import task. | |`status` |String |initialized |Task status: the initial status of the task returned upon creation. | |`expired_time`|String |`2025-11-19T14:23:45Z`|The task's expiration time (ISO 8601 UTC). |\ | | | | | ## Request example ```Bash curl -X POST 'https://aisearch.cn-beijing.volces.com/api/v1/dataset/142460036/create_batch_import' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "estimated_count":1500000 }' ``` ## Response example ```Plain Text { "request_id": "a8207cf1-2230-9f9b-a819-324b5b325c19", "result": { "batch_id": "a8fd2b826203421bb977", "status": "initialized", "expired_time": "2025-12-17T21:15:59+08:00" } } ``` ## Error codes See [Common Error Codes](/docs/85296/1544941) :::tip \*说明 To experience more of Viking AI's search capabilities, visit: [Viking AI Search Engine, an integrated intelligent engine for enterprise search, recommendation, and question answering](https://www.volcengine.com/product/AI-Search-Rec). :::