视频/素材库

管理 Seedance 兼容的资产组和资产，用于可复用的视频工作流。

字节 Seedance / 素材库

管理 Seedance 可复用的参考图片和视频资产。

适用于素材审核、人脸审核、角色/场景参考图等场景。如果不涉及素材工作流，则无需调用。

接口信息

项目值
Base URLhttps://video.unigateway.ai
鉴权Authorization: Bearer $UNIGATEWAY_API_KEY

接口列表

操作方法路径
创建素材库POST/api/v3/asset-groups
查询素材库列表GET/api/v3/asset-groups
查询单个素材库GET/api/v3/asset-groups/{groupId}
更新素材库PATCH/api/v3/asset-groups/{groupId}
创建素材POST/api/v3/assets
查询素材列表GET/api/v3/assets
查询单个素材GET/api/v3/assets/{assetId}
更新素材PATCH/api/v3/assets/{assetId}
删除素材DELETE/api/v3/assets/{assetId}

请求体和响应体优先使用 PascalCase 风格字段名：Name、Description、GroupId、URL、AssetType、Id。

创建素材库

curl -X POST "https://video.unigateway.ai/api/v3/asset-groups" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Name": "character-references",
    "Description": "Seedance 可复用角色参考",
    "GroupType": "AIGC"
  }'
字段类型必填说明
Namestring是素材库名称
Descriptionstring否描述
GroupTypestring否未传时默认按 AIGC 处理

响应：

{
  "Id": "group-123"
}

查询素材库列表

curl "https://video.unigateway.ai/api/v3/asset-groups?page_num=1&page_size=50" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY"
  • page_num 默认 1，page_size 默认 50，最大 200
  • 可选过滤：filter.name、filter.group_ids、filter.group_type
  • filter.group_type 如果提供，当前只接受 AIGC
  • 可选 project_name
  • 响应包含 Items、TotalCount、PageNumber、PageSize

创建素材

curl -X POST "https://video.unigateway.ai/api/v3/assets" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Name": "hero-reference-01",
    "AssetType": "Image",
    "URL": "https://<your-domain>/assets/hero-reference-01.jpg",
    "GroupId": "group-123"
  }'
字段类型必填说明
Namestring是资产显示名
URLstring是源文件 URL
GroupIdstring是绑定的素材库 ID
AssetTypestring建议传Image、Video 或 Audio

响应：

{
  "Id": "asset-001"
}

查询素材列表

curl "https://video.unigateway.ai/api/v3/assets?page_num=1&page_size=20&filter.group_ids=group-123&filter.group_type=AIGC" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY"
  • filter.group_ids 必填
  • filter.group_type 必填，当前必须为 AIGC
  • 可选：filter.statuses、filter.name、project_name
  • sort_by：created_at、updated_at、group_id
  • sort_order：asc、desc

更新素材

curl -X PATCH "https://video.unigateway.ai/api/v3/assets/asset-001" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Name": "hero-reference-01-updated"
  }'

当前仅更新 Name。

删除素材

curl -X DELETE "https://video.unigateway.ai/api/v3/assets/asset-001" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY"

响应：

{
  "Id": "asset-001"
}

说明

  • 素材库与素材按账号隔离
  • 请使用接口返回的 Id 进行后续查询、更新与删除
  • 素材库和素材操作支持可选 project_name 参数