curl -X POST https://gogogotoken.com/v1/seedance/asset/CreateAssetGroup \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "Name": "我的素材组" }'
curl -X POST https://gogogotoken.com/v1/seedance/asset/CreateAsset \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"Name": "参考图1",
"AssetType": "Image",
"URL": "https://assets.example.com/photo.jpg"
}'
curl -X POST https://gogogotoken.com/v1/seedance/asset/CreateAsset \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"Name": "参考图1",
"AssetType": "Image",
"Data": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
}'
curl -X POST https://gogogotoken.com/v1/seedance/asset/ListAssets \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"Filter": {
"GroupIds": ["group_xxx"],
"GroupType": "AIGC"
},
"PageNumber": 1,
"PageSize": 20
}'
Seedance 素材
素材管理 API
Seedance 原生素材接口:创建组、上传、查询与列表(gogogotoken.com)
POST
/
v1
/
seedance
/
asset
/
CreateAssetGroup
curl -X POST https://gogogotoken.com/v1/seedance/asset/CreateAssetGroup \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "Name": "我的素材组" }'
curl -X POST https://gogogotoken.com/v1/seedance/asset/CreateAsset \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"Name": "参考图1",
"AssetType": "Image",
"URL": "https://assets.example.com/photo.jpg"
}'
curl -X POST https://gogogotoken.com/v1/seedance/asset/CreateAsset \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"Name": "参考图1",
"AssetType": "Image",
"Data": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
}'
curl -X POST https://gogogotoken.com/v1/seedance/asset/ListAssets \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"Filter": {
"GroupIds": ["group_xxx"],
"GroupType": "AIGC"
},
"PageNumber": 1,
"PageSize": 20
}'
Seedance 素材管理共 8 个端点,均为 POST 请求。不同 API Key 之间的素材数据完全隔离。
也可在控制台 素材管理 中查看素材组、复制
Base URL:
https://gogogotoken.com。路径前缀:/v1/seedance/asset/。字段名注意大小写:GroupId、Id、PageNumber。asset:// 链接、解绑组。
curl -X POST https://gogogotoken.com/v1/seedance/asset/CreateAssetGroup \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "Name": "我的素材组" }'
curl -X POST https://gogogotoken.com/v1/seedance/asset/CreateAsset \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"Name": "参考图1",
"AssetType": "Image",
"URL": "https://assets.example.com/photo.jpg"
}'
curl -X POST https://gogogotoken.com/v1/seedance/asset/CreateAsset \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"Name": "参考图1",
"AssetType": "Image",
"Data": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
}'
curl -X POST https://gogogotoken.com/v1/seedance/asset/ListAssets \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"Filter": {
"GroupIds": ["group_xxx"],
"GroupType": "AIGC"
},
"PageNumber": 1,
"PageSize": 20
}'
接口列表
| 接口 | 端点 | 说明 |
|---|---|---|
| CreateAssetGroup | POST /v1/seedance/asset/CreateAssetGroup | 创建素材组(免费) |
| CreateAsset | POST /v1/seedance/asset/CreateAsset | 登记素材(¥0.10 / 次) |
| GetAssetGroup | POST /v1/seedance/asset/GetAssetGroup | 查询素材组 |
| GetAsset | POST /v1/seedance/asset/GetAsset | 查询单个素材 |
| ListAssetGroups | POST /v1/seedance/asset/ListAssetGroups | 分页列出素材组 |
| ListAssets | POST /v1/seedance/asset/ListAssets | 分页列出素材 |
| UpdateAssetGroup | POST /v1/seedance/asset/UpdateAssetGroup | 更新素材组 |
| UpdateAsset | POST /v1/seedance/asset/UpdateAsset | 更新素材 |
CreateAssetGroup
curl -X POST https://gogogotoken.com/v1/seedance/asset/CreateAssetGroup \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "Name": "我的素材组" }'
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
Name | string | 是 | 素材组名称 |
Description | string | 否 | 描述 |
CreateAsset
登记公网素材到指定素材组,成功扣费 ¥0.10 / 次。创建素材组CreateAssetGroup 免费。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
GroupId | string | 否 | 所属素材组 ID。部分渠道的素材组已由平台固定,可不填;填写后在这类渠道会被忽略。具体请咨询管理员 |
Name | string | 是 | 素材名称 |
AssetType | string | 是 | Image 或 Video |
URL | string | 二选一 | 公网 HTTPS 图片/视频地址 |
Data | string | 二选一 | 图片/视频的 base64 内容(可含 data: 前缀)。平台会自动转存后登记,无需自备图床 |
URL 与 Data 二选一:已有公网直链用 URL;只有本地原图用 Data 传 base64,平台自动转存为公网素材,无需你自己搭图床。GetAsset
curl -X POST https://gogogotoken.com/v1/seedance/asset/GetAsset \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "Id": "asset_xxx" }'
ListAssets
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
Filter.GroupIds | string[] | 是 | 素材组 ID 列表 |
Filter.GroupType | string | 是 | 素材组类型,常用 AIGC |
PageNumber | number | 否 | 页码,从 1 开始 |
PageSize | number | 否 | 每页数量,默认 20 |
在图生视频中引用
登记成功后,在 视频生成 的metadata.content 中使用:
{
"type": "image_url",
"image_url": { "url": "asset://asset-20260627000800-l6jq6" },
"role": "first_frame"
}
常见问题
上传报 URL 无效? 换一张能公网直接打开的https 链接;或改用 Data 字段直接传图片 base64,由平台自动转存,无需自备图床。
asset:// 图生报找不到素材?
确认 asset 由当前 Key 上传且素材组未解绑。可先改用公网图片链接验证流程。
字段名写错?
使用 GroupId、Id、PageNumber,不是 group_id、GroupID、Page。⌘I
