Skip to main content
POST
/
v1
/
seedance
/
asset
/
CreateAssetGroup
curl -X POST https://gogogotoken.ai/v1/seedance/asset/CreateAssetGroup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "Name": "我的素材组" }'
Seedance 素材管理共 8 个端点，均为 POST 请求。不同 API Key 之间的素材数据完全隔离。
Base URL：https://gogogotoken.ai。路径前缀：/v1/seedance/asset/。字段名注意大小写：GroupId、Id、PageNumber。
也可在控制台 素材管理 中查看素材组、复制 asset:// 链接、解绑组。 
curl -X POST https://gogogotoken.ai/v1/seedance/asset/CreateAssetGroup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "Name": "我的素材组" }'

​
接口列表

接口端点说明
CreateAssetGroupPOST /v1/seedance/asset/CreateAssetGroup创建素材组
CreateAssetPOST /v1/seedance/asset/CreateAsset登记素材（按次少量计费）
GetAssetGroupPOST /v1/seedance/asset/GetAssetGroup查询素材组
GetAssetPOST /v1/seedance/asset/GetAsset查询单个素材
ListAssetGroupsPOST /v1/seedance/asset/ListAssetGroups分页列出素材组
ListAssetsPOST /v1/seedance/asset/ListAssets分页列出素材
UpdateAssetGroupPOST /v1/seedance/asset/UpdateAssetGroup更新素材组
UpdateAssetPOST /v1/seedance/asset/UpdateAsset更新素材

​
CreateAssetGroup

curl -X POST https://gogogotoken.ai/v1/seedance/asset/CreateAssetGroup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "Name": "我的素材组" }'
参数类型必填说明
Namestring是素材组名称
Descriptionstring否描述

​
CreateAsset

参数类型必填说明
GroupIdstring是所属素材组 ID
Namestring是素材名称
AssetTypestring是Image 或 Video
URLstring是公网 HTTPS 图片/视频地址（不支持本地文件、base64）

​
GetAsset

curl -X POST https://gogogotoken.ai/v1/seedance/asset/GetAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "Id": "asset_xxx" }'

​
ListAssets

参数类型必填说明
Filter.GroupIdsstring[]是素材组 ID 列表
Filter.GroupTypestring是素材组类型，常用 AIGC
PageNumbernumber否页码，从 1 开始
PageSizenumber否每页数量，默认 20

​
在图生视频中引用

登记成功后，在 视频生成 的 metadata.content 中使用： 
{
  "type": "image_url",
  "image_url": { "url": "asset://asset_xxx" },
  "role": "first_frame"
}

​
常见问题

上传报 URL 无效？ 换一张能公网直接打开的 https 链接。 asset:// 图生报找不到素材？ 确认 asset 属于当前 Key；素材组未解绑；且与推理 endpoint 在同一 BytePlus 项目。可先改用公网图片链接。 字段名写错？ 使用 GroupId、Id、PageNumber，不是 group_id、GroupID、Page。