可灵视频生成 — 查询结果

查询可灵视频生成任务状态并获取视频

GET

/tasks/{task_id}

查询任务状态

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "340f0d7d-bf7e-4c8f-9c03-xxxxxx",
  "output": {
    "task_id": "24f5c51e-d67b-44dc-9acb-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-27 21:30:32.575",
    "scheduled_time": "2026-03-27 21:30:32.603",
    "end_time": "2026-03-27 21:31:09.177",
    "video_url": "https://v4-fdl.kechuangai.com/ksc2/xxx.mp4?xxxx",
    "watermark_video_url": "https://v2-fdl.kechuangai.com/ksc2/xxx.mp4?xxxx"
  },
  "usage": {
    "duration": 5,
    "size": "1280*720",
    "fps": 24,
    "video_count": 1,
    "audio": false,
    "SR": "720"
  }
}

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

轮询策略

通过提交任务接口提交任务，保存返回的 task_id。
每 15 秒轮询一次，直到 task_status 变为 SUCCEEDED 或 FAILED。
任务成功后，从 video_url 下载视频。

注意事项

视频 URL 有效期：video_url 和 watermark_video_url 在 30 天后过期，请及时下载。
task_id 查询有效期：task_id 仅在提交后 24 小时内有效。超出后查询返回 task_status: UNKNOWN。
查询频率限制：接口 RPS 限制为 20，建议以 15 秒为间隔轮询。
状态流转：PENDING → RUNNING → SUCCEEDED / FAILED。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

路径参数

string

必填

任务 ID，由提交任务接口返回。

响应

200-application/json

string

请求唯一标识符。

object

显示子属性

string

任务 ID。

enum<string>

任务状态。PENDING：等待中；RUNNING：生成中；SUCCEEDED：成功；FAILED：失败；UNKNOWN：task_id 查询有效期（24 小时）已过期。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,UNKNOWN

string

任务提交时间。

string

任务调度时间。

string

任务结束时间。

string

生成的视频 URL，任务成功后返回，有效期 30 天。

string

带水印视频 URL，任务成功且 watermark=true 时返回，有效期 30 天。

string

实际使用的提示词（经模型改写后）。

string

错误码，任务失败时返回。

string

错误信息，任务失败时返回。

object

用量统计，任务成功后返回。

显示子属性

number

视频时长（秒）。

string

视频分辨率，格式如 1280*720。

integer

帧率（FPS）。

integer

生成的视频数量。

boolean

是否包含音频。

string

超分辨率信息。

​轮询策略

​注意事项

鉴权

路径参数

响应

轮询策略

注意事项