Query asset - iviker 维克 AI 视频文档

Query a single asset’s status and details.

GET /v1/assets/{id}
Authorization: Bearer <API_KEY>

id is the asset_xxx value returned by Create asset. Do not include the asset:// prefix. This endpoint is usually used to poll processing status until status=active, then the asset can be used in video generation.

Example

curl "https://{your-domain}/v1/assets/asset_6f9a4c2b8d1e3a90" \
  -H "Authorization: Bearer $API_KEY"

Processing response:

{
  "id": "asset_6f9a4c2b8d1e3a90",
  "uri": "asset://asset_6f9a4c2b8d1e3a90",
  "object": "asset",
  "asset_type": "image",
  "name": "avatar-reference",
  "status": "processing",
  "created_at": 1779782400,
  "updated_at": 1779782400
}

Ready response:

{
  "id": "asset_6f9a4c2b8d1e3a90",
  "uri": "asset://asset_6f9a4c2b8d1e3a90",
  "object": "asset",
  "asset_type": "image",
  "name": "avatar-reference",
  "status": "active",
  "created_at": 1779782400,
  "updated_at": 1779782460
}

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

Error codes

HTTP status	`error.type`	Scenario
404	`asset_not_found`	The asset does not exist, does not belong to the current user/domain, or the asset ID is invalid.