跳转到主要内容
千问 AI 平台 home page
文档
Vidu 图像生成

Vidu -- 查询结果

查询 Vidu 图像生成任务的状态与结果。

GET
/tasks/{task_id}
cURL
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "f584a817-6e00-9841-961a-49f7382a03d4",
  "output": {
    "task_id": "6404d4ec-4cdf-45b5-8d7d-3d429c6baed5",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-07-13 20:27:41.291",
    "scheduled_time": "2026-07-13 20:27:41.320",
    "end_time": "2026-07-13 20:28:39.767",
    "finished": true,
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [
            {
              "image": "https://example.com/generated-image.png",
              "type": "image"
            }
          ]
        }
      }
    ]
  },
  "usage": {
    "SR": "2K",
    "size": "2048*2048",
    "image_count": 1
  }
}
提交任务后，建议每隔 5 秒轮询一次该接口，直到 task_status 为 SUCCEEDED 或 FAILED。

任务状态流转

PENDING -> RUNNING -> SUCCEEDED 或 FAILED
状态说明
PENDING任务排队等待中
RUNNING任务生成中
SUCCEEDED任务成功，可获取图片链接
FAILED任务失败，查看 code 和 message 字段获取原因
CANCELED任务已取消
UNKNOWN任务不存在或已过期（超过 24 小时）
  • 成功响应中的图片下载链接有效期为 24 小时，请及时下载保存。
  • 支持配置异步回调，免去主动轮询。详见配置异步回调。

错误码

请参见错误信息。

鉴权

​
string
header
必填

千问 AI 平台 API Key。详见获取 API Key。

Header 参数

​
string
必填

千问 AI 平台 API Key。详见获取 API Key。

路径参数

​
string
必填

任务 ID。将上一步接口返回的 task_id 完整替换。查询有效期为 24 小时。

响应

200-application/json
​
string

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

示例:f584a817-6e00-9841-961a-49f7382a03d4
​
object

任务输出信息。

​
object

资源用量信息。只对成功的结果计数。