文档中心

火山方舟

批量(Job) API

创建批量推理任务

POST https://ark.cn-beijing.volcengineapi.com/?Action=CreateBatchInferenceJob&Version=2024-01-01

创建批量推理任务。为了避免异常情况下重复提交任务带来额外推理和计费，平台在创建批量推理任务时提供幂等控制：当用户、项目名（Project Name）、存储桶（bucket）和输入文件名（object-key）完全相同时，平台仅保留一个任务处于活跃状态（运行或排队），其他重复提交将报错，并在错误信息中包含在运行或排队中任务的 ID，供用户查询。

注意

批量推理任务有以下使用约束：

输入文件需为 JSONL 格式，每行一个请求；输出为模型推理结果。

输入与输出存储桶均需位于华北 2-北京地域（cn-beijing），且与任务在同一账号下。

同一用户、项目、存储桶和输入文件下，平台仅保留一个活跃任务（运行或排队），重复提交会报错并返回已存在任务的 ID。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

Access Key 鉴权，请在 Access Key 管理页面，获取 Access Key。本接口仅支持 Access Key 鉴权。

请求参数

Body 参数

InputFileTosLocation object 必选 | 输入文件

ModelReference object 必选 | 模型引用

Name string 必选 | 任务名称

OutputDirTosLocation object 必选 | 输出文件夹

CompletionWindow string | 最大等待时间

Description string | 任务描述

DryRun boolean 默认值 false | 预检请求

ProjectName string 默认值 default | 项目名称

Tags object[] | 任务标签

响应参数

Id string | 任务 ID

默认

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=CreateBatchInferenceJob&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
    "Name": "批量推理任务",
    "Description": "这是一个批量推理任务",
    "ModelReference": {
      "FoundationModel": {
        "Name": "doubao-seed-2-0-pro",
        "ModelVersion": "260215"
      }
    },
    "InputFileTosLocation": {
      "BucketName": "my-bucket-name",
      "ObjectKey": "batch-inference-job/dataset/my-job.jsonl"
    },
    "OutputDirTosLocation": {
      "ObjectKey": "batch-inference-job/output/",
      "BucketName": "my-bucket-name"
    },
    "ProjectName":"default",
    "CompletionWindow": "1d",
    "Tags": [
      {
        "Key": "test_key",
        "Value": "test_value"
      }
    ]
}
'

Response

{
  "ResponseMetadata": {
    "RequestId": "20240918194640ECB302768CB287CEDA",
    "Action": "CreateBatchInferenceJob",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "bi-20240918194641-r2nwq"
  }
}

最近更新时间：2026.11.05 17:57:03

这个页面对您有帮助吗？

有用

无用