表情包视频 Emoji — 查询结果

查询表情包视频生成状态

GET

/tasks/{task_id}

cURL

# 请将 86ecf553-d340-4e21-xxxxxxxxx 替换为真实的 task_id
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "ad225054-6c94-47e5-9356-xxxxxxx",
  "output": {
    "task_id": "b56f509a-3ea9-4cfe-848d-xxxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-10-14 11:28:04.372",
    "scheduled_time": "2025-10-14 11:28:04.400",
    "end_time": "2025-10-14 11:29:03.924",
    "video_url": "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xx.mp4?Expires=xxx"
  },
  "usage": {
    "video_duration": 2,
    "video_ratio": "standard"
  }
}

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

轮询策略

调用创建任务接口获取 task_id。
每 15 秒轮询一次，直到 task_status 为 SUCCEEDED 或 FAILED。
任务成功后，从 output.video_url 获取视频。

注意事项

URL 有效期：视频 URL 在 24 小时后过期，请及时下载。
状态流转：PENDING → RUNNING → SUCCEEDED 或 FAILED。UNKNOWN 表示任务不存在或已过期。

鉴权

string

header

必填

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

Header 参数

string

必填

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

路径参数

string

必填

任务ID。由创建任务接口返回。

响应

200-application/json

string

请求唯一标识。可用于请求明细溯源和问题排查。

示例:ad225054-6c94-47e5-9356-xxxxxxx

object

任务输出信息。

显示子属性

string

任务ID。查询有效期24小时。

示例:b56f509a-3ea9-4cfe-848d-xxxxxxx

enum<string>

任务状态。

枚举值：

PENDING：任务排队中
RUNNING：任务处理中
SUCCEEDED：任务执行成功
FAILED：任务执行失败
CANCELED：任务已取消
UNKNOWN：任务不存在或状态未知

轮询过程中的状态流转：

PENDING（排队中） → RUNNING（处理中）→ SUCCEEDED（成功）/ FAILED（失败）。
初次查询状态通常为 PENDING（排队中）或 RUNNING（处理中）。
当状态变为 SUCCEEDED 时，响应中将包含生成的视频URL。
若状态为 FAILED，请检查错误信息并重试。

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

string

任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。

示例:2025-10-14 11:28:04.372

string

任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。

示例:2025-10-14 11:28:04.400

string

任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。

示例:2025-10-14 11:29:03.924

string

视频URL。仅在 task_status 为 SUCCEEDED 时返回。链接有效期24小时，可通过此URL下载视频。视频格式为MP4（H.264 编码）。

示例:http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xx.mp4?Expires=xxx

string

请求失败的错误码。请求成功时不会返回此参数，详情请参见错误信息。

string

请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误信息。

object

输出信息统计，只对成功的结果计数。

显示子属性

integer

生成视频的时长，单位为秒。计费公式：费用 = 视频秒数 × 单价。

示例:2

string

生成视频的画幅，固定为standard，表示生成1:1画幅的视频。

示例:standard

​轮询策略

​注意事项

鉴权

Header 参数

路径参数

响应

轮询策略

注意事项