查询任务结果

查询 qwen-mt-image 图像翻译任务状态和结果

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": "5fec62eb-bf94-91f8-b9f4-f7f758e4e27e",
  "output": {
    "task_id": "72c52225-8444-4cab-ad0c-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-08-13 18:11:16.954",
    "scheduled_time": "2025-08-13 18:11:17.003",
    "end_time": "2025-08-13 18:11:23.860",
    "image_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx?Expires=xxx"
  },
  "usage": {
    "image_count": 1
  }
}

鉴权

string

header

必填

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

路径参数

string

必填

任务标识。由创建接口返回的 task_id。

响应

200-application/json

string

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

object

任务输出信息。

显示子属性

string

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

enum<string>

任务状态。

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

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

string

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

string

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

string

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

string

模型生成图像的 URL 地址，与原图长宽相同，JPG 格式。有效期为 24 小时，请及时下载并保存图像。

string

附加信息。通常不会返回此参数，仅在图像中无可翻译文本时，任务仍会成功并正常计费，但会返回 No text detected for translation 的提示；任务失败时会返回失败详情。

string

请求失败的错误码。请求成功时不会返回此参数。

object

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

显示子属性

integer

模型生成图像的数量，固定为 1。