创意文字纹理 — 查询结果

查询创意文字纹理生成任务的状态和结果

GET

/tasks/{task_id}

查询任务结果

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

{
  "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
  "output": {
    "task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-08-15 10:46:20.054",
    "scheduled_time": "2025-08-15 10:46:20.087",
    "end_time": "2025-08-15 10:46:27.768",
    "results": [
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/1.jpg"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/2.jpg"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/3.jpg"
      },
      {
        "url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/4.jpg"
      }
    ]
  },
  "usage": {
    "image_count": 4
  }
}

查询任务状态并获取生成的文字纹理图片。

轮询策略

通过提交创意文字纹理任务接口提交任务，获取 task_id。
每 5 秒轮询一次，直到 task_status 为 SUCCEEDED 或 FAILED。
任务成功后，从 results 数组中获取各图片的 url。

注意事项

URL 有效期：生成的图片 URL 有效期为 24 小时，请及时下载。
任务状态流转：PENDING → RUNNING → SUCCEEDED、FAILED 或 UNKNOWN。
任务 ID 有效期：task_id 有效期为 24 小时，过期后无法查询状态和结果。

鉴权

string

header

必填

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

路径参数

string

必填

任务 ID，由生成文字纹理接口返回。

响应

200-application/json

string

请求唯一标识。

object

显示子属性

string

任务 ID。

enum<string>

当前任务状态。状态流转：PENDING → RUNNING → SUCCEEDED 或 FAILED。UNKNOWN 表示任务不存在或查询已超过 24 小时。

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

string

任务提交时间。

string

任务调度时间。

string

任务结束时间。

object[]

生成结果列表，每个元素包含一张图片的 URL。

显示子属性

string

生成的图片 URL。

object

显示子属性

integer

总任务数。

integer

成功任务数。

integer

失败任务数。

string

错误码（仅在任务失败时返回）。

string

错误信息（仅在任务失败时返回）。

object

显示子属性

integer

生成的图片数量。

​轮询策略

​注意事项

鉴权

路径参数

响应

轮询策略

注意事项