GET
/
v1
/
assets
列出素材
curl --request GET \
  --url https://api.novawander.cn/v1/assets \
  --header 'Authorization: <authorization>'

简介

列出当前用户素材,并自动刷新处理中素材的上游状态。

认证

Authorization
string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx

查询参数

group_id
string
按素材组 ID 筛选;指定后忽略 group_type
group_type
string
默认值:"aigc"
aigc、liveness_face 或 all。未传时默认仅返回虚拟素材库下的素材

请求示例

# 默认:虚拟素材库
curl "https://api.novawander.cn/v1/assets" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

# 指定素材组
curl "https://api.novawander.cn/v1/assets?group_id=group-20260508120000-abcde" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

# 真人素材库全部
curl "https://api.novawander.cn/v1/assets?group_type=liveness_face" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

响应示例

{
  "assets": [
    {
      "virtual_id": "asset-20260508120145-pqwhc",
      "asset_url": "asset://asset-20260508120145-pqwhc",
      "group_id": "group-20260508120000-abcde",
      "url": "https://signed-url.example.com/...",
      "filename": "portrait.jpg",
      "asset_type": "Image",
      "status": "active",
      "created_at": 1715140800
    }
  ],
  "total": 1
}
响应中的 url 为上游临时签名 URL(约 12 小时),仅用于预览。视频生成须使用 asset_url(asset://),不要使用 url。