查询任务

文档版本：v1.0.0 | 最后更新：2026-06-11
本平台已完整适配 Vidu 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

查询视频生成任务列表及任务详情，获取生成结果。

GET https://platform.shuyanai.com/vidu/ent/v2/tasks

请求参数

请求头

头部	必填	说明
`Content-Type`	是	`application/json`
`Authorization`	是	`Bearer {API_KEY}`

查询参数

参数	类型	必填	说明
`task_ids`	Array	可选	查询的任务 ID 列表。精确搜索。
`states`	Array	可选	查询任务的状态。默认为全部。可选值：`created`、`queueing`、`processing`、`success`、`failed`
`model_versions`	Array	可选	查询任务的模型版本，如 `q1`、`q2`。
`templates`	Array	可选	查询的场景模板。
`resolutions`	Array	可选	查询任务的分辨率。
`created_at.from`	String	可选	查询任务列表的开始时间。默认 7 天前。
`created_at.to`	String	可选	查询任务列表的结束时间。默认当前时间。
`pager.page`	Int	可选	页码。默认从第 0 页开始。
`pager.pagesz`	Int	可选	每页条数。默认 10，最大 100。
`pager.page_token`	String	可选	下一次查询的起始 token。

请求示例

查询指定任务

查询成功的任务列表

响应参数

字段	子字段	类型	说明
`next_page_token`		String	传入此 token 查询下一页
`tasks`		Array	任务列表
	`id`	String	任务 ID
	`key_id`	String	创建任务时使用的 API Key ID
	`type`	String	任务类型
	`template`	String	场景模板枚举值（仅 template 类型任务返回）
	`model`	String	使用的模型
	`prompt`	String	提示词
	`images`	Array	使用的图片
	`duration`	Int	生成时长
	`resolution`	String	分辨率
	`aspect_ratio`	String	宽高比
	`state`	String	处理状态：`created`、`queueing`、`processing`、`success`、`failed`
	`creations`	Array	生成物信息（任务成功时返回）
	`creations.id`	String	生成物 ID
	`creations.url`	String	生成物 URL（不带水印），24 小时有效
	`creations.watermarked_url`	String	生成物 URL（带水印），24 小时有效
	`creations.cover_url`	String	生成物封面，24 小时有效
	`creations.video`	Object	视频信息
	`creations.video.duration`	Float	视频时长
	`creations.video.fps`	Int	视频帧率
	`creations.video.resolution.width`	Int	视频宽度（px）
	`creations.video.resolution.height`	Int	视频高度（px）
	`created_at`	String	任务创建时间
	`credits`	Int	消耗的积分数

注意：视频 URL 有效期为 24 小时，请及时下载或转存。

响应示例

{
  "next_page_token": "",
  "tasks": [
    {
      "id": "{task_id}",
      "key_id": "{key_id}",
      "type": "text2video",
      "model": "viduq3-pro",
      "prompt": "An astronaut walks through the fog.",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "state": "success",
      "creations": [
        {
          "id": "{creation_id}",
          "url": "https://example.com/video.mp4",
          "cover_url": "https://example.com/cover.jpg",
          "watermarked_url": "https://example.com/video_wm.mp4",
          "video": {
            "duration": 5.0,
            "fps": 24,
            "resolution": {
              "width": 1280,
              "height": 720
            }
          }
        }
      ],
      "created_at": "2025-01-01T15:41:31.968916Z",
      "credits": 8
    }
  ]
}

08-查询任务

查询任务#

请求参数#

请求头#

查询参数#

请求示例#

查询指定任务#

查询成功的任务列表#

响应参数#

响应示例#

查询任务

请求参数

请求头

查询参数

请求示例

查询指定任务

查询成功的任务列表

响应参数

响应示例