GlobalAiOpc
上传素材
上传图片、视频、音频等素材到 Seedance2.0 素材库
Seedance2.0 上传素材
上传素材到 Seedance2.0 素材库,获取素材 ID 用于视频生成任务。
认证
获取 Key所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。请求参数
assetTypestring必填素材类型,首字母大写
可选值:
Image- 图片Video- 视频Audio- 音频Document- 文档
注意首字母必须大写
urlstring必填素材的公网 URL 地址
示例:
https://example.com/image.jpgnamestring素材名称,用于标识和管理素材
示例:
猫咪图片响应参数
codeinteger响应状态码
0- 成功- 其他值 - 失败
msgstring响应消息,成功时为
null,失败时返回错误信息dataobject响应数据对象
素材类型说明
Image(图片)
支持格式:jpeg、png、webp、bmp、tiff、gif
用于
referenceImages、first_image、last_image 参数Video(视频)
支持分辨率:480p、720p
用于
referenceVideos 参数Audio(音频)
支持格式:wav、mp3
用于
referenceAudios 参数Document(文档)
文档类型素材
用于其他场景
使用流程
上传素材
调用上传接口,获取
assetId素材审核
涉及人脸或虚拟人像的素材需要等待审核通过
使用素材
在视频生成任务中使用
asset://{assetId} 格式引用素材使用素材 ID 的优势:
- 素材经过审核,符合平台规范
- 素材存储在平台,访问速度更快
- 避免外部 URL 失效导致的问题
- 可以重复使用已上传的素材
最佳实践:
- 为素材设置有意义的名称,便于管理
- 涉及人脸的图片建议提前上传并等待审核
- 保存好
assetId,可以在多个视频生成任务中重复使用 - 确保素材 URL 在上传时可访问
