GlobalAiOpc

上传素材

上传图片、视频、音频等素材到 Seedance2.0 素材库

POST/kyyReactApiServer/kyyVideo2/asset/upload

Seedance2.0 上传素材

上传素材到 Seedance2.0 素材库,获取素材 ID 用于视频生成任务。
所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

请求参数

assetTypestring必填
素材类型,首字母大写
可选值:
  • Image - 图片
  • Video - 视频
  • Audio - 音频
  • Document - 文档
注意首字母必须大写
urlstring必填
素材的公网 URL 地址
示例:https://example.com/image.jpg
namestring
素材名称,用于标识和管理素材
示例:猫咪图片

响应参数

codeinteger
响应状态码
  • 0 - 成功
  • 其他值 - 失败
msgstring
响应消息,成功时为 null,失败时返回错误信息
dataobject
响应数据对象

素材类型说明

Image(图片)

支持格式:jpeg、png、webp、bmp、tiff、gif
用于 referenceImagesfirst_imagelast_image 参数

Video(视频)

支持分辨率:480p、720p
用于 referenceVideos 参数

Audio(音频)

支持格式:wav、mp3
用于 referenceAudios 参数

Document(文档)

文档类型素材
用于其他场景

使用流程

上传素材

调用上传接口,获取 assetId

素材审核

涉及人脸或虚拟人像的素材需要等待审核通过

使用素材

在视频生成任务中使用 asset://{assetId} 格式引用素材
使用素材 ID 的优势:
  1. 素材经过审核,符合平台规范
  2. 素材存储在平台,访问速度更快
  3. 避免外部 URL 失效导致的问题
  4. 可以重复使用已上传的素材
最佳实践:
  • 为素材设置有意义的名称,便于管理
  • 涉及人脸的图片建议提前上传并等待审核
  • 保存好 assetId,可以在多个视频生成任务中重复使用
  • 确保素材 URL 在上传时可访问