> ## Documentation Index
> Fetch the complete documentation index at: https://doc.octopusx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询素材

> 使用 `POST /v1/seedance/asset/GetAsset` 查询 Seedance 素材导入状态与详情。

# 查询素材

根据 [上传素材](./asset-create-media) 返回的 `task_id` 查询素材处理进度与详情。

## 方法与路径

```http theme={null}
POST /v1/seedance/asset/GetAsset
```

## 请求示例

<CodeGroup>
  ```bash theme={null}
  curl -X POST https://octopusx.ai/v1/seedance/asset/GetAsset \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{
      "task_id": "task_xxxx"
    }'
  ```

  ```python theme={null}
  import requests

  resp = requests.post(
      "https://octopusx.ai/v1/seedance/asset/GetAsset",
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
          "Accept": "application/json",
      },
      json={"task_id": "task_xxxx"},
      timeout=30,
  )
  print(resp.json())
  ```
</CodeGroup>

## 响应示例

<ResponseExample>
  ```json 200 theme={null}
  {
    "state": 1,
    "data": {
      "Id": "asset-xxx",
      "Name": "child",
      "URL": "https://example.com/processed.webp",
      "AssetType": "Image",
      "GroupId": "group-20260415111540-w9pkb",
      "Status": "Active",
      "CreateTime": "2026-04-15T11:15:40Z",
      "UpdateTime": "2026-04-15T11:16:02Z",
      "Error": null
    },
    "error": null
  }
  ```

  ```json 401 theme={null}
  {
    "error": {
      "code": "Unauthorized",
      "message": "Invalid API key provided",
      "type": "new_api_error"
    }
  }
  ```

  ```json 403 theme={null}
  {
    "error": {
      "code": "Forbidden",
      "message": "access denied",
      "type": "new_api_error"
    }
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "code": "NotFound",
      "message": "task not found",
      "type": "new_api_error"
    }
  }
  ```

  ```json 429 theme={null}
  {
    "error": {
      "code": "RateLimitExceeded",
      "message": "当前请求频率过高，请稍后再试",
      "type": "new_api_error"
    }
  }
  ```

  ```json 500 theme={null}
  {
    "error": {
      "code": "InternalError",
      "message": "internal server error",
      "type": "new_api_error"
    }
  }
  ```
</ResponseExample>

## 认证

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Body

<ParamField body="task_id" type="string" required>
  上传素材时返回的任务 ID。
</ParamField>

## Response

<ResponseField name="data.Id" type="string">
  素材 ID。
</ResponseField>

<ResponseField name="data.Name" type="string">
  素材名称。
</ResponseField>

<ResponseField name="data.URL" type="string">
  素材 URL。
</ResponseField>

<ResponseField name="data.AssetType" type="string">
  素材类型：`Image`、`Video`、`Audio`。
</ResponseField>

<ResponseField name="data.GroupId" type="string">
  所属素材组 ID。
</ResponseField>

<ResponseField name="data.Status" type="string">
  素材状态：`Processing`（处理中）、`Active`（可用于视频生成）、`Failed`（失败）。
</ResponseField>

<ResponseField name="data.Error" type="string | null">
  失败时的错误信息。
</ResponseField>

## 相关页面

* [Seedance-2 概览](./overview)
* [创建素材组](./asset-create-group)
* [上传素材](./asset-create-media)
* [创建视频](./generation)