Asset list - iviker 维克 AI 视频文档

List assets for the current API key. Supports filtering by status, type, and name, plus pagination.

GET /v1/assets
Authorization: Bearer <API_KEY>

Query parameters

Parameter	Type	Description
`status`	string	Filter by status: `processing`, `active`, or `failed`.
`asset_type`	string	Filter by type: `image`, `video`, or `audio`.
`name`	string	Fuzzy search by asset name.
`page`	integer	Page number, defaults to `1`.
`page_size`	integer	Items per page, defaults to `20`, max `100`.

Example

curl "https://{your-domain}/v1/assets?asset_type=image&status=active&page=1&page_size=20" \
  -H "Authorization: Bearer $API_KEY"

Response:

{
  "items": [
    {
      "id": "asset_6f9a4c2b8d1e3a90",
      "uri": "asset://asset_6f9a4c2b8d1e3a90",
      "object": "asset",
      "asset_type": "image",
      "name": "avatar-reference",
      "status": "active",
      "created_at": 1779782400,
      "updated_at": 1779782460
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 20
}

Asset statuses

Status	Description	Usable in video generation
`processing`	The platform has accepted the asset and is storing or waiting to process it.	No
`active`	The asset is ready.	Yes
`failed`	Asset processing failed.	No
`disabled`	Asset was disabled by the platform.	No