> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyfast.com.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# seedance-素材-查询素材

> 查询素材列表，支持按名称、素材组 ID、素材组类型过滤。查询操作不计费。

<script src="/feedback.js" />


## OpenAPI

````yaml api-reference/model-api/bytedance/openapi/volc-asset-list-assets/openapi.yaml POST /volc/asset/ListAssets
openapi: 3.1.0
info:
  title: Seedance 2.0 素材 — 查询素材
  description: 通过 Anyfast API 查询素材
  version: 1.0.0
servers:
  - url: https://www.anyfast.com.cn
security:
  - bearerAuth: []
paths:
  /volc/asset/ListAssets:
    post:
      summary: 查询素材
      description: 查询素材列表，支持按名称、素材组 ID、素材组类型过滤。查询操作不计费。
      operationId: listAssets
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListAssetsRequest'
      responses:
        '200':
          description: 查询成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAssetsResponse'
        '401':
          description: 未授权
components:
  schemas:
    ListAssetsRequest:
      type: object
      required:
        - model
        - Filter
      properties:
        model:
          type: string
          description: 模型名称。默认 `volc-asset`。
          example: volc-asset
        Filter:
          $ref: '#/components/schemas/ListAssetsFilter'
        PageNumber:
          type: integer
          description: 页码，默认 `1`。
          example: 1
        PageSize:
          type: integer
          description: 每页数量，默认 `10`。
          example: 10
      example:
        model: volc-asset
        Filter:
          Name: test
          GroupIds:
            - group-20260320141746-zsf6b
          GroupType: LivenessFace
        PageNumber: 1
        PageSize: 10
    ListAssetsResponse:
      type: object
      properties:
        Items:
          type: array
          items:
            type: object
            properties:
              Id:
                type: string
                example: asset-20260320142452-2htjn
              Name:
                type: string
                example: test
              URL:
                type: string
                description: 素材文件 URL。
                example: https://ark-media-asset.tos-cn-beijing.volces.com/...
              AssetType:
                type: string
                example: Image
              GroupId:
                type: string
                example: group-20260320141746-zsf6b
              Status:
                type: string
                example: Active
              Error:
                type: object
                nullable: true
                description: 素材处理失败时返回，例如上传到 LivenessFace 组的人脸与真人认证基准不一致。
                properties:
                  Code:
                    type: string
                    example: FaceMismatch
                  Message:
                    type: string
                    example: Face consistency verification failed
              ProjectName:
                type: string
                example: default
              CreateTime:
                type: string
                example: '2026-03-20T14:24:52Z'
              UpdateTime:
                type: string
                example: '2026-03-20T14:25:01Z'
        PageNumber:
          type: integer
          example: 1
        PageSize:
          type: integer
          example: 10
        TotalCount:
          type: integer
          example: 2
    ListAssetsFilter:
      type: object
      properties:
        Name:
          type: string
          description: 按名称模糊匹配。
          example: test
        GroupIds:
          type: array
          items:
            type: string
          description: 按素材组 ID 列表过滤。
          example:
            - group-20260320141746-zsf6b
        GroupType:
          type: string
          enum:
            - AIGC
            - LivenessFace
          description: 按素材组类型过滤。真人活体认证素材使用 `LivenessFace`。
          example: LivenessFace
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````