查询内容生成任务列表 API

GET

https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks?page_num=1&page_size=100&filter.task_ids=cgt-***&filter.task_ids=cgt-***' \
--header 'Authorization: Bearer 59385462-****' \
--header 'Content-Type: application/json' \
--data-raw ''

响应示例

{
    "items": [
        {
            "model": "string",
            "status": "string",
            "created_at": "string",
            "updated_at": "string",
            "content": {
                "video_url": "string"
            },
            "usage": {
                "completion_tokens": 0
            }
        }
    ],
    "total": 0
}

请求参数

Query 参数

page_num

string

必需

页码，取值范围：[1, 500]。

示例值:

page_size

string

必需

每页数据量，取值范围：[1, 500]

示例值:

100

filter.task_ids

array[string]

必需

过滤参数，查询某个任务状态。

queued：排队中的任务。

running：运行中任务。

cancelled：取消的任务，只能查询到24h内取消的任务。取消任务超出24h，会被删除。取消任务接口请参见取消或删除内容生成任务。

succeeded：成功的任务。

failed：失败的任务。

示例值:

["cgt-***","cgt-***"]

Header 参数

Content-Type

string

必需

示例值:

application/json

Authorization

string

必需

示例值:

Bearer 59385462-****

返回响应

🟢200成功

application/json

Body

items

array [object {6}]

必需

model

string

必需

与请求参数含义不同，此处含义为任务使用的 {模型名称}-{版本}

status

string

必需

created_at

string

必需

updated_at

string

必需

content

object

必需

usage

object

必需

total

integer

必需

修改于 2025-02-28 07:32:06

查询视频生成任务信息 API

取消或删除内容生成任务