---
title: "素材任务查询接口"
method: GET
path: "/assets/{task_id}"
tags: ["GetAssetData"]
---

# 素材任务查询接口

`GET /assets/{task_id}`

根据任务ID查询素材生成任务的状态和结果。

## Path parameters

- `task_id` string, uuid, required

## Response `200`

成功响应

- object
  - `id` string, required — 素材ID
  - `status` 'pending' | 'running' | 'succeed' | 'failed', required — 任务状态
  - `name` string — 素材名称
  - `group_id` string — 所属素材组ID
  - `url` string, uri — 素材URL
  - `asset_type` 'Image' | 'Video' | 'Audio' — 素材类型

## Other responses

- `400` — 参数验证错误
- `401` — 未授权
- `404` — 任务不存在
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)