查询视频 API​

GET https://art-api.yuyuflow.com/api/v3/contents/generations/tasks/{id}

查询视频生成任务的状态。

说明

仅支持查询最近 7 天的任务记录，时间区间为 [T-7天, T)，其中 T 为请求发起时刻的 UTC 时间戳（精确到秒）。注意：视频 URL 有效期为 24 小时，请及时下载或转存。

鉴权​

本接口仅支持 API Key 鉴权，请在 https://art-api.yuyuflow.com/dashboard/overview 获取 API Key。

请求参数​

id string 必选

您需要查询的视频生成任务的 ID。

说明

上面参数为 Query String Parameters，在 URL String 中传入。

响应参数​

id string

视频生成任务 ID。

model string

任务使用的模型名称和版本，模型名称-版本。

status string

任务状态：

  • queued：排队中。
  • running：任务运行中。
  • cancelled：取消任务，取消状态 24h 自动删除（只支持排队中状态的任务被取消）。
  • succeeded：任务成功。
  • failed：任务失败。
  • expired：任务超时。

error object / null

错误提示信息，任务成功返回 null，任务失败时返回错误数据。错误信息具体参见错误处理。

  • error.code string：错误码。
  • error.message string：错误提示信息。

created_at integer

任务创建时间的 Unix 时间戳（秒）。

updated_at integer

任务当前状态更新时间的 Unix 时间戳（秒）。

content object

视频生成任务的输出内容。

  • content.video_url string：生成视频的 URL，格式为 mp4。有效期为 24 小时，请及时下载或转存。
  • content.last_frame_url string：视频的尾帧图像 URL。有效期为 24 小时，请及时下载或转存。仅创建视频生成任务时设置 "return_last_frame": true 时返回。

seed integer

本次请求使用的种子整数值。

resolution string

生成视频的分辨率。

ratio string

生成视频的宽高比。

duration integer

生成视频的时长，单位：秒。

说明

duration 和 frames 参数只会返回一个。创建视频生成任务时未指定 frames，会返回 duration。

frames integer

生成视频的帧数。

说明

duration 和 frames 参数只会返回一个。创建视频生成任务时指定了 frames，会返回 frames。

framespersecond integer

生成视频的帧率。

generate_audio boolean

生成的视频是否包含与画面同步的声音。仅 Seedance 2.0 & 2.0 Fast、Seedance 1.5 Pro 会返回该参数。

  • true：模型输出的视频包含同步音频。
  • false：模型输出的视频为无声视频。

tools object[]

本次请求模型实际使用的工具。未使用工具时不返回。

  • tools.type string：实际使用的工具类型。
    • web_search：联网搜索工具。

safety_identifier string

终端用户的唯一标识符。若创建视频生成任务时设置了该参数，接口会原样返回此信息。

priority integer

当前请求的执行优先级。

draft boolean

生成的视频是否为 Draft 视频。仅 Seedance 1.5 Pro 会返回该参数。

  • true：表示当前输出为 Draft 视频。
  • false：表示当前输出为正常视频。

draft_task_id string

Draft 视频任务 ID。基于 Draft 视频生成正式视频时，会返回该参数。

service_tier string

实际处理任务使用的服务等级。

execution_expires_after integer

任务超时阈值，单位：秒。

usage object

本次请求的 token 用量。

  • usage.completion_tokens integer：模型生成视频消耗的 token 数量，可作为计费对账依据。

说明

Seedance 2.0 系列模型存在最低 token 用量限制，如果实际 token 用量 ＜ 最低 token 用量，本字段会返回最低 token 用量，平台按最低 token 用量计费。

  • usage.total_tokens integer：本次请求消耗的总 token 数量。视频生成模型不统计输入 token，输入 token 为 0，故 total_tokens = completion_tokens。

  • usage.tool_usage object：使用工具的用量信息。

    • usage.tool_usage.web_search integer：实际调用联网搜索工具的次数，仅开启联网搜索时返回。