上传素材
在指定素材组中导入素材。URL 用于把公网 HTTPS 资源拉取进素材库(审核 / 转码由服务端完成)。导入成功后返回 AssetId,在 创建视频 中推荐用 asset://{assetId} 引用,而不是重复填写公网 URL。
http
POST /v1/seedance/asset/CreateAsset请求头
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 请求身份认证。使用 Bearer Token,示例: | |
| string | 是 | 请求内容类型,必须设置为 |
请求体
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 素材组 ID,来自 创建素材组 返回的 data.Id | |
| string | 是 | 待导入素材的公网 HTTPS 地址 | |
| string | 是 | 素材类型:、、 | |
| string | 是 | 素材名称 |
请求示例
bash
curl -X POST https://octopusx.ai/v1/seedance/asset/CreateAsset \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"GroupId": "group-20260412163933-zwxdc",
"URL": "https://example.com/source.webp",
"AssetType": "Image",
"Name": "child"
}'响应示例
json
{
"state": 1,
"data": {
"Id": "asset-xxx",
"task_id": "task_xxx"
},
"error": null
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
| integer | 业务状态, 为成功 | |
| string | 素材 ID(),生成请求中用 引用 | |
| string | 导入任务 ID,用于 查询素材 轮询 | |
| object | 错误信息,成功时为 |