跳到主要内容

查询任务

PinduCloud 提供本页所列接口。请求使用 PinduCloud API Key；模型开通情况以当前账号的可用模型为准，参数按本页对应型号的协议组织。

通过 task_id 轮询任意万相异步任务（文生视频、图生视频、参考生视频、视频编辑、首尾帧、动作迁移、数字人、VACE）的状态及结果。

接口定义​

GET https://video.pinducloud.com.cn/ali/api/v1/tasks/{task_id}

路径参数​

参数类型必填说明
task_idstring是创建任务时返回的 output.task_id，用于查询本站保留的任务记录

请求头​

参数类型必填说明
Authorizationstring是Bearer sk-your-pinducloud-token

请求示例​

curl --request GET \
  --url 'https://video.pinducloud.com.cn/ali/api/v1/tasks/{task_id}' \
  --header 'Authorization: Bearer sk-your-pinducloud-token'

响应说明​

处理中（PENDING / RUNNING）​

{
  "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "RUNNING",
    "submit_time": "2026-07-22 11:31:35.916",
    "scheduled_time": "2026-07-22 11:31:35.973"
  }
}

成功（SUCCEEDED）​

{
  "request_id": "caa62a12-0972-9762-96c7-8cd0cd10bc9f",
  "output": {
    "task_id": "eff1443c-b8b0-42b4-a973-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-07-22 11:31:35.916",
    "scheduled_time": "2026-07-22 11:31:35.973",
    "end_time": "2026-07-22 11:35:14.377",
    "orig_prompt": "一只猫在草地上奔跑",
    "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx"
  },
  "usage": {
    "duration": 5,
    "input_video_duration": 0,
    "output_video_duration": 5,
    "video_count": 1,
    "SR": 1080
  }
}

失败（FAILED）​

{
  "request_id": "xxxx",
  "output": {
    "task_id": "xxxx",
    "task_status": "FAILED",
    "code": "InvalidParameter",
    "message": "The size is not match xxxxxx"
  }
}

任务不存在​

以下为业务错误结构示意。请同时检查 HTTP 状态码；鉴权或请求校验错误的包装可能不同。遇到该错误时，核对创建响应中的公开任务 ID 和所属用户，不要因此重复创建视频。

{
  "code": "task_not_exist",
  "message": "task_not_exist",
  "data": null
}

响应字段​

output​

字段类型说明
task_idstring任务 ID
task_statusstring任务状态：PENDING、RUNNING、SUCCEEDED、FAILED、CANCELED、UNKNOWN
submit_time / scheduled_time / end_timestring任务提交 / 开始执行 / 完成时间，格式 YYYY-MM-DD HH:mm:ss.SSS
video_urlstring生成的视频地址，仅 SUCCEEDED 时返回；MP4（H.264），有效期以实际返回地址为准
orig_promptstring原始输入提示词
actual_promptstring开启 prompt_extend 时返回的改写后提示词（部分模型不返回）
code / messagestring仅 FAILED 时返回错误码与详情

usage​

不同模型系列的用量字段略有差异，下表为可能返回的字段，并非每个型号都返回全部字段。usage 表示任务服务报告的用量，最终计费规则和金额以本站模型价格及使用日志为准。

字段类型适用模型说明
durationnumber按型号返回原生用量时长（秒），含义以该型号为准；不能一律视为输入与输出时长之和
input_video_durationnumberWan 3.0 及提供该统计的型号输入视频时长（秒）；完整报告的纯生成任务通常为 0，缺失不等同于 0
output_video_durationnumberWan 3.0 及提供该统计的型号输出视频时长（秒），可能含小数
SRinteger同上输出分辨率档位，如 480、720、1080
ratiostringwan2.7输出宽高比，如 16:9
sizestringwan2.6输出分辨率「宽*高」，如 1920*1080
video_durationnumberwan2.5 及更早、animate原生视频时长（秒），可能含小数
video_ratiostringwan2.5 及更早为「宽*高」；animate 为 standard / pro输出规格标识
video_countinteger全部生成视频数量，固定 1

使用建议​

  • 生成耗时通常 1–5 分钟，建议以 15 秒左右的间隔轮询；请勿因等待而重复创建任务。
  • 任务记录的查询可用期以本站记录保留策略为准；生成结果链接有有效期，请及时下载或转存。
  • 实际请求限额由本站配置和账号权限决定，请控制轮询频率。