You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
批量(Job) API
获取批量推理任务
复制全文
下载 pdf
获取批量推理任务
POST https://ark.cn-beijing.volcengineapi.com/?Action=GetBatchInferenceJob&Version=2024-01-01​
获取批量推理任务的详细信息,包括任务状态、模型引用、请求计数等。​
说明​
任务状态机:Queued → Initializing → Running → Completed;运行中可经由 StopBatchInferenceJob 进入 Terminating → Terminated,失败时进入 Failed。处于 Terminated / Failed 状态的任务可通过 ResumeBatchInferenceJob 重启。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。本接口仅支持 Access Key 鉴权。​
​​
请求参数​
Body 参数​
Id string 必选 | 任务 ID​
​
​
响应参数​
CompletionWindow string | 最大等待时间​
​
CreateTime string | 创建时间​
​
Description string | 任务描述​
​
ErrorFileTosLocation object | 错误信息文件​
​
ExpireTime string | 到期时间​
​
Id string | 任务 ID​
​
InputFileTosLocation object | 输入文件​
​
ModelReference object | 模型引用​
​
Name string | 任务名称​
​
OutputDirTosLocation object | 输出文件夹​
​
ProjectName string | 项目名称​
​
RequestCounts object | 请求数量​
​
Status object | 任务状态​
​
Tags object[] | 任务标签​
​
UpdateTime string | 更新时间​
​
​

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetBatchInferenceJob&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 '{
    "Id": "bi-20240918194641-r2nwq"
}
'

Response

{
    "ResponseMetadata": {
        "RequestId": "2024091910512025A35A851624E45418",
        "Action": "GetBatchInferenceJob",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "bi-20240918194641-r2nwq",
        "Name": "批量推理任务",
        "Description": "这是一个批量推理任务",
        "InputFileTosLocation": {
            "BucketName": "my-bucket-name",
            "ObjectKey": "batch-inference-job/dataset/my-job.jsonl"
        },
        "OutputDirTosLocation": {
            "BucketName": "my-bucket-name",
            "ObjectKey": "batch-inference-job/output/"
        },
        "CompletionWindow": "1d",
        "Status": {
            "Phase": "Completed",
            "PhaseTime": "2024-09-18T11:50:00Z",
            "Message": "批量推理任务已完成"
        },
        "ModelReference": {
            "FoundationModel": {
                "Name": "doubao-seed-2-0-pro",
                "ModelVersion": "260215"
            }
        },
        "RequestCounts": {
            "Total": 2,
            "Completed": 2,
            "Failed": 0
        },
        "Tags": [
            {
                "Key": "owner",
                "Value": "team-a"
            },
            {
                "Key": "test_key",
                "Value": "test_value"
            }
        ],
        "ProjectName": "default",
        "CreateTime": "2024-09-18T11:46:41Z",
        "UpdateTime": "2024-09-18T11:50:00Z",
        "ExpireTime": "2024-09-19T11:46:41Z"
    }
}
最近更新时间:2026.09.04 20:18:47
这个页面对您有帮助吗?
有用
有用
无用
无用