GET
/
v1
/
assets
/
{virtual_id}
查询单个素材
curl --request GET \
  --url https://api.novawander.cn/v1/assets/{virtual_id} \
  --header 'Authorization: <authorization>'

​
简介

查询单个素材详情，并自动刷新上游处理状态。生成视频前请确认 status 为 active。

​
认证

​
Authorization
string
必填
Bearer Token，如 Bearer sk-xxxxxxxxxx

​
路径参数

​
virtual_id
string
必填
素材 ID（如 asset-20260508120145-pqwhc，与 asset_url 中 asset:// 后部分一致）

​
请求示例

curl "https://api.novawander.cn/v1/assets/asset-20260508120145-pqwhc" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

​
状态说明

status说明
pending上游异步处理中（含人脸识别等），继续轮询
active可用，可写入 asset:// 参与视频生成
failed处理失败，请检查素材规格后重新上传
网关会验证素材所有权，只能使用自己上传的素材。