You need to enable JavaScript to run this app.
导航
CreateBatchImport - 创建批量导入任务
最近更新时间:2025.12.17 00:04:59首次发布时间:2025.12.17 00:04:59
复制全文
我的收藏
有用
有用
无用
无用

调用本接口创建一个批量导入数据任务,获取一个唯一的任务标识,您可后续通过此标识批量导入物品数据,或查询任务状态。
当前我们支持创建物品数据的批量导入任务。

注意事项

任务有效期: 每个批量导入任务的有效生命周期为24小时,您需要在创建任务的24小时内完成数据导入并通过调用导入任务完成接口提交这批数据。过期后任务将自动失效。
创建任务请求频度:​创建批量导入任务限制每分钟创建1个。请避免频繁创建多个批量导入任务。

请求说明

请求参数

参数

类型

是否必选

示例

描述

estimated_count

Integer

可选

1000000

预估本次批量导入的数据总条数。

响应参数

请求响应

参数

类型

示例

描述

batch_id

String

6c0001b0-f696-4bfc-acda-a2ee05170485

批式导入任务的唯一标识符。

status

String

initialized

任务状态:在创建任务时返回任务的初始状态。

expired_time

String

2025-11-19T14:23:45Z

任务的过期时间 (ISO 8601 UTC时间)。

请求示例

curl -X POST 'https://aisearch.cn-beijing.volces.com/api/v1/dataset/142460036/create_batch_import \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <API Key>' \
  -d '{
    "estimated_count":1500000
}'

返回示例

{
    "request_id": "a8207cf1-2230-9f9b-a819-324b5b325c19",
    "result": {
        "batch_id": "a8fd2b826203421bb977",
        "status": "initialized",
        "expired_time": "2025-12-17T21:15:59+08:00"
    }
}

错误码

请查看公共错误码