GlobalAiOpc

Seedance2.0 - 素材提交

提交 Seedance2.0 素材,获取 assetId 后用于视频生成

POST/kyyReactApiServer/asset/seedance2/assetUpload

Seedance2.0 素材提交

提交图片、视频或音频素材,返回 assetId。视频生成时请使用 assetId://{assetId} 引用我方素材。
cURL
Authorization: Bearer {{key}}

基础 URL

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

请求参数

assetTypestring必填
素材类型:ImageVideoAudio
urlstring必填
调用方原始素材 URL,需可被服务端访问;当前不支持 base64 入参。
namestring
素材名称,超过 50 个 Unicode 字符会自动截断。

响应参数

assetIdstring
素材 ID。
assetTypestring
素材类型。
urlstring
原始素材 URL。
statusstring
素材状态,提交后通常为 PROCESSING。只有 ACTIVE 状态的素材可以提交视频生成任务。
errorMessagestring
素材处理失败时的错误信息;无错误时为 null
namestring
素材名称。

素材状态说明

  • NONE:素材记录已创建,但尚未开始上传或处理。请稍后查询素材详情,当前不可提交任务。
  • UPLOADING:素材正在上传。请等待状态更新,当前不可提交任务。
  • PROCESSING:素材已提交,正在处理中。请继续查询素材详情,当前不可提交任务。
  • ACTIVE:素材已处理完成且可用。只有此状态可以提交视频生成任务。
  • FAILED:素材处理失败。请查看 errorMessage,处理问题后重新提交素材。
  • EXPIRED:素材已过期,当前不可用。请重新查询素材详情并等待重新处理为 ACTIVE,必要时重新提交素材。
  • DELETED:素材已被删除或已失效,当前不可用。请重新提交素材并等待状态变为 ACTIVE